Introduction
Fonction de cet endpoint
Envoie un prompt à Recraft V4 et renvoie un SVG natif.
Entrées essentielles
prompt (jusqu’à 10,000 caractères) décrit le design. aspect_ratio sélectionne l’un des sept formats de plan de travail ; la valeur par défaut est 1:1.
Résultat obtenu
Un fichier .svg (MIME image/svg+xml) composé de tracés.
| Champ | Valeur |
|---|---|
| Entrée | Texte |
| Sortie | Image |
| Longueur du prompt | Jusqu’à 10,000 caractères |
| Rapports largeur/hauteur | 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 |
Fonctionnalités et points forts
Un renard et un badge de boulangerie, tous deux modifiables
À gauche : un logo de renard bicolore composé de 18 formes. À droite : un badge de boulangerie rétro portant le nom Rise & Crumb, encadré d’épis de blé, avec 124 formes crème et brunes. Les deux se sont ouverts dans un éditeur vectoriel où chaque élément pouvait être sélectionné.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Précisez le sujet, le format (logo, badge, illustration en aplats), la palette et tout nom à intégrer entre guillemets. 1 caractères minimum · 10000 caractères maximum |
aspect_ratio | Non | 1:1 (par défaut), 4:3, 3:4, 3:2, 2:3, 16:9 ou 9:16. Définit les proportions du plan de travail du SVG ; le format ne change pas le prix. |
Tarification
$0.096 / SVG
Un tarif fixe par SVG livré, quel que soit le format du plan de travail ; les requêtes échouées et les résultats vides ne sont pas facturés.
Cas d’utilisation
Exploration de logos
Générez plusieurs logos pour un nouveau produit ou commerce, puis finalisez le meilleur dans un éditeur vectoriel.
Illustration éditoriale en aplats
Créez des illustrations d’accompagnement pour vos blogs, pages d’accueil et présentations, nettes sur tous les écrans.
Visuels prêts à imprimer
Créez des badges, des étiquettes et des visuels d’emballage vectoriels que l’imprimeur pourra agrandir sans perte.
Guide de prompt et conseils pratiques
Rédigez le brief
Décrivez le sujet, le style (logo, badge, illustration en aplats) et les couleurs. Placez tout nom à intégrer au logo entre guillemets.
Choisissez un format
Choisissez
aspect_ratio: 1:1 convient aux logos et aux badges, 3:2 ou 16:9 aux scènes et aux bannières.Modifiez le SVG
Téléchargez le fichier .svg et ouvrez-le dans Figma, Illustrator ou Inkscape pour ajuster les couleurs, l’espacement et les lettres.
Introduction
Recraft V4 Vector transforme un brief écrit en fichier SVG. Recraft a conçu V4 pour les designers, en soignant la composition, les couleurs et la géométrie. Cet endpoint utilise son mode vectoriel.
Fonctionnalités et points forts
Géométrie nette et superposée
Les formes sont des tracés distincts : vous pouvez recolorer l’oreille d’un renard ou déplacer le ruban d’un badge sans rien redessiner.
Des palettes respectées
Lors de nos essais, les palettes indiquées dans le prompt, comme bleu canard et corail ou crème et brun, ont été fidèlement suivies.
Des noms intégrés au design
Les noms courts comme Rise & Crumb sont dessinés comme partie intégrante du visuel.
Cas d’usage
Ébauches d’identité de marque
Explorez des logos et des badges pour une nouvelle entreprise avant de confier le meilleur à un designer.
Illustrations pour le Web et les applications
Créez des illustrations d’en-tête et d’états vides qui restent nettes sur tous les écrans.
Emballages et étiquettes
Dessinez des visuels d’étiquettes pouvant être agrandis pour l’impression.
Guide des prompts et conseils pratiques
Commencez par le format
Commencez par logo, emblème, badge ou illustration en aplats pour que le modèle adopte le bon niveau de détail.
Gardez des logos simples
Pour les logos, demandez des formes en aplats ou géométriques et deux ou trois couleurs.
Vérifiez le lettrage
Contrôlez l’orthographe et l’espacement, puis ajustez-les dans un éditeur vectoriel si nécessaire.
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/v4-vector/text-to-image",
"input": {
"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.
