Design

Add Pattern Effect

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

file· Resultado de archivoAbrir herramienta

Inicio rápido

Llama a esta herramienta desde tu código en tres lenguajes.

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/es/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'

Referencia de la API

Envía una petición POST con tus entradas en JSON. Los parámetros de tipo archivo requieren una subida previa.

Endpoint

HTTP

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción
imageFile	filesubida requerida	Sí	Upload any image file to add pattern effect to
patternType	select	No	Choose the type of geometric pattern
foregroundColor	color	No	Color of the pattern elements
backgroundColor	color	No	Background color of the pattern
size	number	No	Size of pattern elements (1-50 pixels)
spacing	number	No	Spacing between pattern elements (5-100 pixels)
opacity	number	No	Opacity of the pattern (0.0 to 1.0)
rotation	number	No	Rotation angle of the pattern (0-360 degrees)
blendMode	select	No	Choose how the pattern blends with the image
outputFormat	select	No	Choose output format or keep original
quality	number	No	Output quality for lossy formats (WebP, JPEG)

Los parámetros de tipo archivo deben subirse primero mediante POST /upload/image-add-pattern; el filePath devuelto se pasa luego al campo correspondiente.

Formato de respuesta

Resultado de archivo

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

Integración MCP

Añade esta herramienta a tu servidor Model Context Protocol para que los agentes de IA puedan listarla y llamarla.

Configuración del servidor

Añade este bloque a la configuración de tu 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 herramientas disponibles

Tras conectar al endpoint SSE, lista las herramientas expuestas:

tools/list

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

Llamar a esta herramienta

Invoca la herramienta por su id; los argumentos se construyen a partir de sus 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
}
  }
}

Encadena varias herramientas en una sesión con una lista toolId separada por comas, p. ej. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Los parámetros de archivo aceptan únicamente una URL de archivo pública (https://…). No se admiten rutas locales, data: URI ni cadenas Base64.

¿Dudas o problemas? Contacta con [email protected]