Elysia Tools Docs
ES
Idioma
ZHESPTRUFRDEEN
Volver al sitio
Explorar herramientas

Design

Transformación Afín de Imagen

Aplicar transformación afín para escalado, rotación, cizalla y traslación

file· Resultado de archivoAbrir herramienta

Inicio rápido

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

cURL
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-affine' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"imageFile.ext","contentType":"application/octet-stream","size":12345}'

# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
  --data-binary @/path/to/file.ext

# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/es/api/tools/image-affine' \
  -F 'imageFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'scaleX=1.0' \
  -F 'scaleY=1.0' \
  -F 'angle=0' \
  -F 'shearX=0' \
  -F 'shearY=0' \
  -F 'translateX=0' \
  -F 'translateY=0' \
  -F 'background=transparent' \
  -F 'format=original' \
  -F 'quality=95'

© 2026 Elysia Tools. Documentación para desarrolladores.

Volver al sitioExplorar herramientas

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-affine

Parámetros

NombreTipoObligatorioDescripción
imageFilefilesubida requeridaSíSube cualquier archivo de imagen (JPEG, PNG, WebP, GIF, BMP, TIFF) para transformación afín
scaleXrangeNoFactor de escalado horizontal (0.1 a 10.0, 1.0 = tamaño original)
scaleYrangeNoFactor de escalado vertical (0.1 a 10.0, 1.0 = tamaño original)
anglerangeNoÁngulo de rotación en grados (-180 a 180, 0 = sin rotación)
shearXrangeNoFactor de cizalla horizontal (-2.0 a 2.0, 0 = sin cizalla)
shearYrangeNoFactor de cizalla vertical (-2.0 a 2.0, 0 = sin cizalla)
translateXrangeNoTraslación horizontal en píxeles (-1000 a 1000, 0 = sin traslación)
translateYrangeNoTraslación vertical en píxeles (-1000 a 1000, 0 = sin traslación)
backgroundtextNoColor de fondo para áreas transparentes (hex #RRGGBB o #RRGGBBAA, o nombre de color)
formatselectNoElige formato de salida o mantén el original. PNG recomendado para transparencia
qualitynumberNoCalidad de salida para formatos con pérdida (JPEG, WebP). Mayor = mejor calidad pero archivo más grande
Los parámetros de tipo archivo deben subirse primero mediante POST /upload/image-affine; 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-affine": {
      "name": "image-affine",
      "description": "Aplicar transformación afín para escalado, rotación, cizalla y traslación",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-affine",
      "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-affine",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "scaleX": "1.0",
  "scaleY": "1.0",
  "angle": "0",
  "shearX": "0",
  "shearY": "0",
  "translateX": "0",
  "translateY": "0",
  "background": "transparent",
  "format": "original",
  "quality": 95
}
  }
}
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]

Explorar herramientas
Abrir herramienta