Homotope FREN

¿Cómo vectorizo imágenes desde un script, una API o un agente de IA (MCP)?

Actualizado el

Crea una clave de API en tu cuenta de Homotope, envía la imagen a POST /api/v1/jobs (o a la herramienta vectorize_image del servidor MCP https://homotope.app/mcp), consulta el cálculo hasta que su estado sea done y recupera el SVG, el PDF, el EPS o el DXF: es un cálculo en el servidor, siempre de pago (cuota Pro y luego créditos).

Logo de un tostador de café sacado de una web, en JPEG comprimido y con ruido: emblema redondo con texto en mayúsculas, taza y rayos, logotipo de texto. JPG · 900 × 640 px
El mismo logo vectorizado en SVG por Homotope: cinco colores planos nítidos y versalitas legibles. SVG del motor
Logo JPEG comprimido y con ruido de 900 × 640 px y SVG producido por el motor, preajuste Logotipo, «Número de colores» en 5, sin retoques: el ruido y los bloques del JPEG desaparecen, el anillo sigue siendo un círculo y las versalitas siguen siendo legibles.
Detalle ×6: la É de «CAFÉ» y su tilde: ruido y bloques del JPEG, bordes nítidos en el SVG. Desliza el control para comparar; pasa el ratón por la imagen o mantén el dedo encima para mover la lupa.
Probar con tu imagen Abrir este ejemplo en el taller

Con la API REST

  1. En el taller, «Mi cuenta» y luego «Claves de API»: crea una clave. Solo se muestra una vez; guárdala en un gestor de secretos.
  2. Envía un PNG o un JPEG: POST /api/v1/jobs responde enseguida con 202 y el identificador del cálculo.
  3. Consulta GET /api/v1/jobs/ID cada 2 a 5 segundos hasta done y descarga el SVG, o …/result?format=dxf (pdf, eps, separaciones).
curl -sS https://homotope.app/api/v1/jobs \
        -H "Authorization: Bearer $HOMOTOPE_API_KEY" \
        -F [email protected] \
        -F 'options={"preset":"logo"}'

      curl -sS https://homotope.app/api/v1/jobs/ID \
        -H "Authorization: Bearer $HOMOTOPE_API_KEY"

      curl -sS -o logo.svg https://homotope.app/api/v1/jobs/ID/svg \
        -H "Authorization: Bearer $HOMOTOPE_API_KEY"

Todo se describe en la documentación de la API y en el documento OpenAPI 3.1.

Con un agente de IA (MCP)

El servidor MCP está en https://homotope.app/mcp, con transporte Streamable HTTP, la cabecera Authorization: Bearer y tu clave. Herramientas: vectorize_image, get_job, get_svg, get_result, check_cut («¿listo para el recorte?») y list_vectorizations. Los mismos derechos y los mismos límites que la API.

Qué cambia respecto al taller

Para vectorizar sin enviar nada, quédate en el taller: consulta vectorizar sin subir la imagen. Allí, sin clave, el cálculo es gratis. Exportaciones de fabricación (DXF, EPS, PDF, separaciones): 2 al mes gratis con una cuenta, ilimitadas con Pro; sin Pro, 1 crédito cada una más allá de esas 2.

Para el DXF de corte, consulta imagen a DXF y convertir una imagen en DXF para láser.

Preguntas frecuentes

¿La API tiene una prueba gratuita?

No: las pruebas del mes están reservadas al taller. Una cuenta gratuita puede crear una clave, pero sus envíos se rechazan sin cuota Pro ni créditos.

¿Qué formatos se obtienen?

SVG, PDF, EPS y DXF, además de las separaciones por color; se puede indicar una paleta impuesta en el envío.

¿Dónde va la clave?

Solo en la cabecera Authorization: Bearer, nunca en una URL ni en un repositorio de código.

Preguntas relacionadas

Guías y conversiones

Probar con tu imagen