Design

Transformación de Perspectiva de Imagen

Aplicar transformación de perspectiva para efectos 3D y corrección de perspectiva

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-perspective' \
  -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-perspective' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'topLeftX=224' \
  -F 'topLeftY=96' \
  -F 'topRightX=461' \
  -F 'topRightY=192' \
  -F 'bottomLeftX=64' \
  -F 'bottomLeftY=931' \
  -F 'bottomRightX=589' \
  -F 'bottomRightY=835' \
  -F 'background=transparent' \
  -F 'format=png' \
  -F 'quality=95'

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

Parámetros

Nombre	Tipo	Obligatorio	Descripción
imageFile	filesubida requerida	Sí	Sube cualquier archivo de imagen (JPEG, PNG, WebP, GIF, BMP, TIFF) para transformación de perspectiva
topLeftX	number	No	Coordenada X de la esquina superior izquierda en la salida
topLeftY	number	No	Coordenada Y de la esquina superior izquierda en la salida
topRightX	number	No	Coordenada X de la esquina superior derecha en la salida
topRightY	number	No	Coordenada Y de la esquina superior derecha en la salida
bottomLeftX	number	No	Coordenada X de la esquina inferior izquierda en la salida
bottomLeftY	number	No	Coordenada Y de la esquina inferior izquierda en la salida
bottomRightX	number	No	Coordenada X de la esquina inferior derecha en la salida
bottomRightY	number	No	Coordenada Y de la esquina inferior derecha en la salida
background	text	No	Color de fondo para áreas vacías (hex #RRGGBB o #RRGGBBAA, o nombre de color)
format	select	No	Formato de salida para la imagen resultante (PNG recomendado para transparencia)
quality	number	No	Calidad de salida para formatos con pérdida

Los parámetros de tipo archivo deben subirse primero mediante POST /upload/image-perspective; 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-perspective": {
      "name": "image-perspective",
      "description": "Aplicar transformación de perspectiva para efectos 3D y corrección de perspectiva",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-perspective",
      "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-perspective",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "topLeftX": 224,
  "topLeftY": 96,
  "topRightX": 461,
  "topRightY": 192,
  "bottomLeftX": 64,
  "bottomLeftY": 931,
  "bottomRightX": 589,
  "bottomRightY": 835,
  "background": "transparent",
  "format": "png",
  "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]