Design

Add Pattern Effect

Add geometric pattern overlays to images with customizable colors, size, and rotation

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/image-add-pattern' \
  -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-pattern' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'patternType=dots' \
  -F 'foregroundColor=#000000' \
  -F 'backgroundColor=#ffffff' \
  -F 'size=10' \
  -F 'spacing=20' \
  -F 'opacity=0.8' \
  -F 'rotation=0' \
  -F 'blendMode=overlay' \
  -F 'outputFormat=original' \
  -F 'quality=90'

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

POST https://api.elysiatools.com/pt/api/tools/image-add-pattern

Parâmetros

Nome	Tipo	Obrigatório	Descrição
imageFile	fileupload necessário	Sim	Upload any image file to add pattern effect to
patternType	select	Não	Choose the type of geometric pattern
foregroundColor	color	Não	Color of the pattern elements
backgroundColor	color	Não	Background color of the pattern
size	number	Não	Size of pattern elements (1-50 pixels)
spacing	number	Não	Spacing between pattern elements (5-100 pixels)
opacity	number	Não	Opacity of the pattern (0.0 to 1.0)
rotation	number	Não	Rotation angle of the pattern (0-360 degrees)
blendMode	select	Não	Choose how the pattern blends with the image
outputFormat	select	Não	Choose output format or keep original
quality	number	Não	Output quality for lossy formats (WebP, JPEG)

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/image-add-pattern; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

JSON

{
  "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)"
}

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-image-add-pattern": {
      "name": "image-add-pattern",
      "description": "Add geometric pattern overlays to images with customizable colors, size, and rotation",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-add-pattern",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "image-add-pattern",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "patternType": "dots",
  "foregroundColor": "#000000",
  "backgroundColor": "#ffffff",
  "size": 10,
  "spacing": 20,
  "opacity": 0.8,
  "rotation": 0,
  "blendMode": "overlay",
  "outputFormat": "original",
  "quality": 90
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]