Introduction
Rôle de cet endpoint
Appelle Recraft 20B en mode SVG et renvoie un fichier vectoriel.
Paramètres importants
prompt décrit le sujet. style sélectionne l’un des 21 styles (par défaut : vector_illustration). aspect_ratio vaut 1:1, 16:9, 9:16, 4:3 ou 3:4.
Résultat renvoyé
Un fichier .svg (MIME image/svg+xml).
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Image |
| Styles | 21 (10 d’icônes, 11 d’illustrations) |
| Formats d’image | 1:1, 16:9, 9:16, 4:3, 3:4 |
Fonctionnalités et points forts
Un modèle, deux styles d’icônes
À gauche : une tasse à café en icon/colored_outline, avec 14 tracés, des contours bruns et des aplats doux. À droite : une icône de voyage avec montagne et soleil en icon/outline, composée de 13 tracés au trait. Un même style dans toute la série permet d’obtenir des icônes assorties.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Un sujet unique est plus lisible, surtout pour les icônes : une tasse de café fumante ou une montagne avec un soleil levant. Précisez les couleurs souhaitées avec des mots. 1 caractères minimum · 1000 caractères maximum |
style | Non | Dix styles d’icônes (outline, |
aspect_ratio | Non | 1:1 (par défaut) pour les icônes ; 16:9, 9:16, 4:3 ou 3:4 pour les bannières et les scènes. Définit la forme du canevas SVG sans supplément. |
Tarification
$0.053 / SVG
Chaque icône ou illustration livrée est facturée à un tarif fixe, quels que soient le style et le format choisis. Aucun frais n’est facturé si la génération échoue.
Cas d’utilisation
Séries d’icônes pour applications et sites web
Générez des icônes pour les menus, les fonctionnalités et les états vides dans un même style, puis adaptez leurs couleurs à votre interface.
Visuels rapides pour blogs et réseaux sociaux
Créez en quelques secondes une petite illustration cartoon ou kawaii pour une publication ou une newsletter.
Projets créatifs et d’impression
Utilisez le dessin au trait, la gravure ou la linogravure pour des autocollants, des tampons, des machines de découpe et des cartes imprimées.
Guide de prompt et conseils pratiques
Choisissez un style
Choisissez un style icon/* pour les icônes d’interface ou vector_illustration/* pour les scènes. Le style par défaut est
vector_illustration.Décrivez un seul sujet
Les icônes fonctionnent mieux avec un seul objet, par exemple une tasse de café fumante ou une montagne avec un soleil levant.
Récupérez le SVG
Interrogez régulièrement l’état de la tâche, téléchargez le fichier .svg et ajoutez-le à votre outil de conception ou à votre code.
Introduction
Recraft 20B SVG génère des icônes et des illustrations vectorielles rapidement et à petit prix. Au lieu de décrire un style avec des mots, vous le choisissez dans une liste de 21 styles prédéfinis.
Fonctionnalités et points forts
21 styles prédéfinis
Les styles d’icônes comprennent outline, broken_line, colored_outline, colored_shapes, colored_shapes_gradient, doodle_fill, doodle_offset_fill, offset_fill, outline_gradient et uneven_fill. Les styles d’illustrations comprennent cartoon, doodle_line_art, engraving, flat_2, kawaii, line_art, line_circuit, linocut et seamless.
Des résultats rapides
Nos générations ont pris environ 11 secondes chacune, ce qui facilite la création d’icônes par lots.
Des fichiers légers
Les icônes obtenues pesaient 20–25 KB.
Cas d’usage
Bibliothèques d’icônes pour produits
Générez une série cohérente pour la navigation, les réglages et les listes de fonctionnalités.
Illustrations de contenu
Ajoutez une image cartoon ou kawaii à un article, une newsletter ou une diapositive.
Autocollants et tampons
Utilisez la linogravure, la gravure ou le dessin au trait pour l’impression et les machines de découpe.
Guide des prompts et conseils pratiques
Un objet par icône
Les prompts courts, comme une montagne avec un soleil levant, donnent des icônes plus nettes que les longues descriptions de scènes.
Gardez le même style pour une série
Utilisez la même valeur de style pour chaque icône d’une série.
Évitez le texte dans les icônes
Le modèle maîtrise mal les lettres ; ajoutez les libellés dans votre outil de conception.
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": "recraft/20b-svg/text-to-image",
"input": {
"style": "vector_illustration",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1"
}
}'
# 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.
