Design
使用形状、渐变或自定义遮罩为图像添加遮罩效果,用于创意合成
用三种语言从你的代码中调用此工具。
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-add-masking' \
-F 'file=@/path/to/imageFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/zh/api/tools/image-add-masking' \
-F 'imageFile=/path/to/file.ext' \
-F 'maskType=shape' \
-F 'maskShape=circle' \
-F 'maskPosition=center' \
-F 'maskSize=80' \
-F 'featherRadius=0' \
-F 'invertMask=false' \
-F 'outputFormat=png' \
-F 'quality=90'以 JSON 形式 POST 提交输入参数。文件类型参数需先单独上传。
POST https://api.elysiatools.com/zh/api/tools/image-add-masking| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| imageFile | file需先上传 | 是 | 应用遮罩效果的图片 |
| maskType | select | 否 | 要应用的遮罩类型 |
| maskShape | select | 否 | 遮罩的形状(当遮罩类型为形状时) |
| maskPosition | select | 否 | 遮罩的位置 |
| maskSize | number | 否 | 遮罩大小占图像尺寸的百分比 |
将此工具加入你的 Model Context Protocol 服务,让 AI 智能体可以列出并调用它。
将以下内容加入你的 MCP 客户端配置:
{
"mcpServers": {
"elysiatools-image-add-masking": {
"name": "image-add-masking",
"description": "使用形状、渐变或自定义遮罩为图像添加遮罩效果,用于创意合成",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-add-masking",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}连接到 SSE 端点后,列出已开放的工具:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}通过工具 id 调用,参数由其参数表构建:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "image-add-masking",
"arguments": {
"imageFile": "https://example.com/file.ext",
"maskType": "shape",
"maskShape": "circle",
"maskPosition": "center",
"maskSize": 80,
"featherRadius": 0,
"invertMask": false,
"outputFormat": "png",
"quality": 90
}
}
}| featherRadius |
| number |
| 否 |
| 遮罩的软边缘半径(0为硬边缘) |
| invertMask | checkbox | 否 | 反转遮罩效果(隐藏遮罩区域而不是显示) |
| outputFormat | select | 否 | 结果图片的输出格式 |
| quality | number | 否 | 有损格式的输出质量 |
文件结果
{
"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)"
}有问题或反馈?请联系 [email protected]