Design
Aplicar efeitos de máscara a imagens usando formas, gradientes ou máscaras personalizadas para composições criativas
Chame esta ferramenta a partir do seu código em três idiomas.
# 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/pt/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'Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.
POST https://api.elysiatools.com/pt/api/tools/image-add-masking| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| imageFile | fileupload necessário | Sim | Imagem para aplicar efeito de máscara |
| maskType | select | Não | Tipo de máscara para aplicar |
| maskShape | select | Não | Forma da máscara (quando tipo é forma) |
| maskPosition | select | Não | Posição da máscara |
| maskSize | number | Não | Tamanho da máscara como porcentagem das dimensões da imagem |
| featherRadius | number | Não | Raio de borda suave para a máscara (0 para bordas duras) |
| invertMask | checkbox | Não | Inverter o efeito da máscara (ocultar área mascarada) |
| outputFormat | select | Não | Formato de saída para a imagem resultante |
| quality | number | Não | Qualidade de saída para formatos com perda |
Resultado de arquivo
{
"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)"
}Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.
Adicione este bloco à configuração do seu cliente MCP:
{
"mcpServers": {
"elysiatools-image-add-masking": {
"name": "image-add-masking",
"description": "Aplicar efeitos de máscara a imagens usando formas, gradientes ou máscaras personalizadas para composições criativas",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-add-masking",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}Após conectar ao endpoint SSE, liste as ferramentas expostas:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:
{
"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
}
}
}Dúvidas ou problemas? Contate [email protected]