Comment vectoriser des images depuis un script, une API ou un agent IA (MCP) ?

Mis à jour le 6 octobre 2026

Créez une clé d’API dans votre compte Homotope, envoyez l’image à POST /api/v1/jobs (ou à l’outil vectorize_image du serveur MCP https://homotope.app/mcp), sondez le calcul jusqu’à l’état done puis récupérez le SVG, le PDF, l’EPS ou le DXF : c’est un calcul serveur, toujours payant (quota Pro, puis crédits).

JPG · 400 × 400 px

SVG du moteur

Logo JPEG compressé de 400 × 400 px et SVG produit par le moteur, préréglage Logo seul, 5 couleurs, sans retouche : les artefacts du JPEG disparaissent, l’anneau reste un cercle et l’étoile garde ses bords droits.

Détail ×6 : le bout de la bande orange contre le liseré blanc : halo et blocs du JPEG, bord net du SVG. Glissez le curseur pour comparer ; survolez l’image ou gardez le doigt dessus pour déplacer la loupe.

Essayer avec votre image Ouvrir cet exemple dans l’atelier

Par l’API REST

Dans l’atelier, « Mon compte » puis « Clés d’API » : créez une clé. Elle n’est affichée qu’une fois ; gardez-la dans un gestionnaire de secrets.
Envoyez un PNG ou un JPEG : POST /api/v1/jobs répond aussitôt 202 avec l’identifiant du calcul.
Sondez GET /api/v1/jobs/ID toutes les 2 à 5 secondes jusqu’à done, puis téléchargez le SVG, ou …/result?format=dxf (pdf, eps, séparations).

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"

Tout est décrit dans la documentation de l’API et le document OpenAPI 3.1.

Par un agent IA (MCP)

Le serveur MCP est à l’adresse https://homotope.app/mcp, en transport Streamable HTTP, avec l’en-tête Authorization: Bearer et votre clé. Outils : vectorize_image, get_job, get_svg, get_result, check_cut (« prêt pour la découpe ? ») et list_vectorizations. Mêmes droits et mêmes limites que l’API.

Ce qui change par rapport à l’atelier

L’image est envoyée : l’API calcule sur le serveur, contrairement à l’atelier.
Toujours payant : chaque calcul prend le quota Pro du mois, puis un crédit ; pas d’essai gratuit par l’API (un calcul échoué est rendu). Montants sur la page Tarifs.
Aucune réponse synchrone : le client sonde.

Pour vectoriser sans rien envoyer, restez dans l’atelier : voir vectoriser sans envoyer l’image. Là, sans clé, le calcul est gratuit. Exports de fabrication (DXF, EPS, PDF, séparations) : 2 par mois gratuits avec un compte, illimités en Pro ; sans Pro, 1 crédit chacun au-delà des 2.

Pour le DXF de découpe, voyez image en DXF et convertir une image en DXF laser.

Questions fréquentes

L’API a-t-elle un essai gratuit ?

Non : les essais du mois sont réservés à l’atelier. Un compte gratuit peut créer une clé, mais ses envois sont refusés sans quota Pro ni crédit.

Quels formats en retour ?

SVG, PDF, EPS et DXF, plus les séparations par couleur ; une palette imposée est possible à l’envoi.

Où mettre la clé ?

Dans l’en-tête Authorization: Bearer seulement, jamais dans une URL ni dans un dépôt de code.

Questions voisines

Guides et conversions

Essayer avec votre image