Design

Recortar Imagen con Tolerancia

Recorte avanzado de imágenes con niveles de tolerancia configurables para eliminación precisa de bordes

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-trim-tolerance' \
  -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-trim-tolerance' \
  -F 'imageFile=/path/to/file.ext' \
  -F 'toleranceMode=absolute' \
  -F 'toleranceValue=40' \
  -F 'autoDetectBackground=true' \
  -F 'backgroundColor=Manual background color (overrides auto-detect)' \
  -F 'scanMethod=full' \
  -F 'edgeSampling=true' \
  -F 'analyzeOnly=false' \
  -F 'format=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-trim-tolerance

Parámetros

Nombre	Tipo	Obligatorio	Descripción
imageFile	filesubida requerida	Sí	Sube cualquier archivo de imagen (JPEG, PNG, WebP, TIFF) para recorte avanzado con tolerancia
toleranceMode	select	Sí	Cómo calcular la tolerancia de color para detección de fondo
toleranceValue	range	No	Tolerancia para detección de fondo. Mayor = más píxeles considerados fondo
autoDetectBackground	checkbox	No	Analizar bordes de imagen para determinar automáticamente el color de fondo
backgroundColor	color	No	Color de fondo específico para recortar (desactiva detección automática)
scanMethod	select	No	Cómo escanear la imagen para encontrar límites de contenido
edgeSampling	checkbox	No	Agregar relleno proporcional a la tolerancia para evitar cortar contenido de bordes
analyzeOnly	checkbox	No	Analizar configuraciones de tolerancia sin recortar la imagen
format	select	No	Elegir formato de salida o mantener original
quality	number	No	Calidad 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-trim-tolerance; 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-trim-tolerance": {
      "name": "image-trim-tolerance",
      "description": "Recorte avanzado de imágenes con niveles de tolerancia configurables para eliminación precisa de bordes",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-trim-tolerance",
      "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-trim-tolerance",
    "arguments": {
  "imageFile": "https://example.com/file.ext",
  "toleranceMode": "absolute",
  "toleranceValue": 40,
  "autoDetectBackground": true,
  "backgroundColor": "Manual background color (overrides auto-detect)",
  "scanMethod": "full",
  "edgeSampling": true,
  "analyzeOnly": false,
  "format": "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]