Image Gradient Overlay
Add gradient overlay effects to images with customizable colors, directions, and blend modes
API Documentation
Request Endpoint
Request Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| imageFile | file (Upload required) | Yes | Image to apply gradient overlay |
| gradientType | select | No | Type of gradient to apply |
| startColor | color | No | Starting color of the gradient |
| endColor | color | No | Ending color of the gradient |
| direction | number | No | Direction of linear gradient (0-360 degrees) |
| opacity | range | No | Opacity of the gradient overlay (0.0 to 1.0) |
| blendMode | select | No | How to blend the gradient with the image |
| outputFormat | select | No | Output format for the result image |
| quality | number | No | Output quality for lossy formats |
File type parameters need to be uploaded first via POST /upload/image-add-gradient to get filePath, then pass filePath to the corresponding file field.
Response Format
{
"filePath": "/public/processing/randomid.ext",
"fileName": "output.ext",
"contentType": "application/octet-stream",
"size": 1024,
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}
AI MCP Documentation
Add this tool to your MCP server configuration:
{
"mcpServers": {
"elysiatools-image-add-gradient": {
"name": "image-add-gradient",
"description": "Add gradient overlay effects to images with customizable colors, directions, and blend modes",
"baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-add-gradient",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.
Supports URL file links or Base64 encoding for file parameters.
If you encounter any issues, please contact us at [email protected]