Introduction
Rôle de cet endpoint
Génère un SVG à partir d’un prompt textuel avec Ideogram Vector 1.0. Le fichier est composé de tracés et de dégradés : il se redimensionne librement et s’ouvre sous forme de formes modifiables.
Entrées essentielles
prompt décrit la création. quality permet de choisir low, medium ou high. aspect_ratio définit la forme de la toile parmi 17 proportions. reference_image_urls est facultatif : jusqu’à cinq images pour guider le style.
Résultat obtenu
Un fichier .svg par requête (MIME image/svg+xml).
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Image |
| Source à vectoriser | JPEG, PNG ou WebP, jusqu’à 50 MB |
| Longueur du prompt | Jusqu’à 9,500 caractères |
| Images de référence | Jusqu’à 5 pour les créations générées |
Fonctionnalités et points forts
Un portrait au café recréé en aplats de couleur
Nous avons vectorisé une photo de 1024×1536 avec detailed. Le SVG contenait environ 2,000 tracés et 580 dégradés : cheveux, maille et lumière de la fenêtre sont devenus des aplats de couleur tout en préservant la scène d’origine, pour environ 2 MB.
Une icône PNG à aplats devient 17 tracés nets
Une icône de tasse de café exportée en PNG est devenue un SVG de 6 KB. Ses contours, volutes de vapeur et emblème de feuille correspondent à l’image matricielle. Chaque forme est un tracé distinct : un clic dans un éditeur vectoriel suffit pour changer sa couleur.
simple regroupe les petites formes
À gauche, l’original ; au centre, la vectorisation avec simple ; à droite, avec detailed. simple a réduit le nombre de tracés d’environ 2,000 à moins de 1,000 et la taille du fichier de 2 MB à 1.1 MB. Les contours des cheveux et du pull sont devenus des blocs plus larges.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez le sujet, le style (aplats, dessin au trait, géométrique), les couleurs et les mots à inscrire. 1 caractères minimum · 9500 caractères maximum |
quality | Non | low, medium (par défaut) ou high. Les niveaux supérieurs ajoutent des détails et prennent plus de temps ; chacun a son propre prix par SVG. |
aspect_ratio | Non | Proportions de la toile vectorielle, de 1:4 en hauteur à 4:1 en largeur ; 1:1 par défaut. |
reference_image_urls | Non | Facultatif : jusqu’à cinq images JPEG, PNG ou WebP de 10 MB maximum chacune, comme références de style et de composition. La première a le plus de poids. 5 éléments maximum |
Tarification
Chaque SVG terminé est facturé une seule fois au tarif de son niveau de qualité. Les images de référence n’augmentent le tarif qu’avec high. Les requêtes qui échouent ou ne produisent aucun SVG ne sont pas facturées.
| With references | Qualité: low | Qualité: medium | Qualité: high |
|---|---|---|---|
| $0.174 / image | $0.216 / image | $0.264 / image |
| $0.174 / image | $0.216 / image | $0.432 / image |
Cas d’utilisation
Logos et marques avec lettrage
Demandez un symbole accompagné d’un nom court. Les lettres restent des contours vectoriels nets, sur une carte de visite comme sur une enseigne.
Récupérez un logo en basse résolution
Vectorisez un ancien logo PNG ou JPEG en SVG pour l’imprimer en grand, changer ses couleurs ou le confier à un imprimeur.
Affiches, autocollants et fichiers de découpe
Générez une affiche ou un autocollant en formes vectorielles, ou vectorisez des créations pour des découpeuses vinyle, graveuses laser et logiciels de broderie.
Guide de prompt et conseils pratiques
Choisissez votre tâche
Envoyez prompt pour une nouvelle création (text-to-image) ou
image_urlpour vectoriser une image existante (edit). Les requêtes avecimage_urlsont automatiquement dirigées vers la vectorisation.Choisissez les réglages
Pour une nouvelle création, choisissez quality et
aspect_ratio, ainsi que jusqu’à cinq images de référence si besoin. Pour vectoriser, choisissezdetail_level: detailed ou simple.Téléchargez le SVG
Interrogez l’état de la tâche et téléchargez le .svg depuis le stockage de la plateforme. Ouvrez-le dans Figma, Illustrator ou Inkscape : les tracés et les remplissages sont immédiatement modifiables.
Introduction
La fonction texte vers SVG d’Ideogram Vector 1.0 dessine un nouveau fichier vectoriel à partir d’une description. Elle convient aux logos, emblèmes, affiches, autocollants et illustrations simples qui doivent rester nets à toute taille.
Fonctionnalités et points forts
Sortie vectorielle native
Le modèle renvoie des éléments de tracé et de dégradé, sans image placée dans un conteneur SVG. Ouvrez le fichier dans Figma, Illustrator ou Inkscape pour sélectionner chaque forme.
Un lettrage lisible
Ideogram est connu pour sa typographie. Dans nos essais, des textes courts comme FOXTROT et NORTH SHORE étaient correctement écrits et intégrés à la composition.
Trois niveaux et 17 proportions
low convient aux ébauches rapides, medium à la plupart des travaux et high aux créations les plus détaillées. La toile va du 1:4 vertical au 4:1 horizontal.
Cas d’usage
Ébaucher une identité de marque
Générez plusieurs pistes de logo, puis affinez celle que vous retenez dans un éditeur vectoriel.
Affiches pour événements et commerces
Créez une affiche avec un titre, imprimable en A2 sans pixellisation.
Autocollants et produits dérivés
Créez des motifs pour la découpe vinyle, la sérigraphie ou la broderie, qui nécessitent des fichiers vectoriels.
Guide des prompts et conseils
Décrire clairement le style
Des termes comme aplats, géométrique, dessin au trait, bicolore ou emblème aident le modèle à produire des formes simples et modifiables.
Mettre les mots entre guillemets ou en majuscules
Indiquez le texte exact à inscrire et limitez-vous à quelques mots.
Nommer les couleurs
Aucun réglage de palette n’est proposé : énumérez les couleurs dans le prompt, par exemple bleu marine et pêche.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "ideogram/vector-1/text-to-image",
"input": {
"aspect_ratio": "1:1",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
