Image Masking Effect
Apply masking effects to images using shapes, gradients, or custom masks for creative compositions
API Documentation
Request Endpoint
Request Parameters
| Parameter Name | Type | Required | Description |
|---|---|---|---|
| imageFile | file (Upload required) | Yes | Image to apply masking effect |
| maskType | select | No | Type of mask to apply |
| maskShape | select | No | Shape of the mask (when mask type is shape) |
| maskPosition | select | No | Position of the mask |
| maskSize | number | No | Size of the mask as percentage of image dimensions |
| featherRadius | number | No | Soft edge radius for the mask (0 for hard edges) |
| invertMask | checkbox | No | Invert the mask effect (hide masked area instead of showing it) |
| 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-masking 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-masking": {
"name": "image-add-masking",
"description": "Apply masking effects to images using shapes, gradients, or custom masks for creative compositions",
"baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-add-masking",
"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]