Recraft v4.1 : fiches de prompts texte-image pour les développeurs

Pourquoi une fiche de prompt vaut mieux qu'un prompt jetable

Chaque équipe qui appelle une API texte-image finit par se heurter au même mur : l'image qui rendait vraiment bien a son prompt enfoui dans un fil de discussion, un script jetable ou l'application de notes de quelqu'un. Quand le besoin produit change — « la même illustration, mais en photo » ou « ajoute un titre dans l'image » — personne ne sait quels mots faisaient le travail, alors le prompt est réécrit de zéro et le résultat se met à varier de façon imprévisible.

Une fiche de prompt résout ce problème en traitant le prompt comme un petit document paramétré. Un squelette, quelques blocs remplaçables et une courte liste de contraintes. Changer de style devient une modification d'un seul champ plutôt qu'une réécriture complète, ce qui signifie que vous pouvez comparer vos prompts, les relire dans des pull requests et raisonner sur les raisons d'un changement de sortie.

La fiche rend aussi les régressions de qualité débogables. Si les images se mettent soudainement à mal sortir, vous pouvez isoler par dichotomie : est-ce le bloc sujet, le bloc style, les instructions de mise en page ou la liste négative ? Avec un prompt jetable, la réponse est généralement « tout à la fois ».

Ce guide parcourt un squelette concret adapté à la génération texte-image de Recraft v4.1, et fournit les deux familles de fiches prêtes à copier-coller les plus utilisées par les développeurs : illustration et photographie. La même structure s'étend au contrôle de la mise en page, au texte dans l'image et aux listes négatives.

Ce que contient réellement une fiche

Considérez chaque fiche comme quatre parties :

• Squelette fixe — les blocs ordonnés partagés par chaque prompt de votre base de code.
• Vocabulaire de style remplaçable — les mots qui font basculer la sortie entre illustration et photographie.
• Clauses de contrainte — mise en page, ratio d'aspect, rendu du texte et instructions d'exclusion.
• Étiquette de version — pour que les prompts en production soient traçables jusqu'à la révision exacte qui a produit l'asset.

Rien de tout cela ne nécessite d'outil particulier. Un fichier JSON par fiche, commité dans le dépôt aux côtés du code qui appelle l'API, suffit.

Le squelette de prompt : blocs conservés et blocs variables

Le squelette ci-dessous est délibérément ennuyeux. C'est tout l'intérêt : la partie stable ne devrait jamais avoir besoin d'être éditée, de sorte que l'attention se concentre sur ce qui change.

[SUBJECT]        ce que contient l'image, décrit en langage simple
[STYLE]          vocabulaire de médium et de rendu
[COMPOSITION]    cadrage, caméra ou mise en page, ratio d'aspect
[CONSTRAINTS]    rendu du texte, limites de palette, règles d'interdiction

Quels blocs sont conservés, lesquels sont remplacés

• SUBJECT — conservé. C'est généralement le seul bloc que votre logique produit doit paramétrer (un nom de produit, une description de scène issue des saisies utilisateur).
• STYLE — remplacé. La différence entre illustration et photographie réside presque entièrement ici.
• COMPOSITION — majoritairement remplacé, mais la forme des instructions reste identique (d'abord le cadrage, puis le ratio d'aspect).
• CONSTRAINTS — partiellement partagé. La liste négative et la règle « pas de texte sauf indication contraire » sont souvent globales ; les instructions de rendu du texte dépendent de la requête.

Un modèle minimal sous forme de données

{
  "recipe_id": "product-hero",
  "version": "3",
  "subject": "a ceramic coffee mug on a plain surface",
  "style": "{{style_block}}",
  "composition": "centered, generous negative space above the subject, square aspect",
  "constraints": ["no text in image", "no watermark"],
  "negatives": "{{negative_list_v2}}"
}

Le placeholder {{style_block}} est la couture. Le reste est soit partagé entre les fiches, soit fourni par l'appelant. Quand vous ajouterez plus tard un troisième style — par exemple de la 3D isométrique — vous ajouterez un bloc de style, pas un nouveau fichier de prompt.

Un rappel pratique : gardez le même ordre de blocs dans chaque fiche. Rien ne garantit que le modèle soit sensible à l'ordre de manière documentée, mais votre équipe l'est. Un ordre cohérent rend les prompts comparables et les revues côte à côte pertinentes.

Fiches d'illustration : styles plat, vectoriel et éditorial

Les fiches d'illustration sont le point de départ de la plupart des équipes, car l'illustration tolère bien la simplification — ce qui en fait un bon choix pour tester le squelette sans se battre avec le photoréalisme.

Illustration plate

[SUBJECT] a developer workspace with a laptop, notebook and coffee mug
[STYLE] flat vector illustration, solid fills, no gradients, bold simple shapes, limited four-color palette, clean geometric forms
[COMPOSITION] centered composition, even margins, square aspect
[CONSTRAINTS] no text in image, no shadows, no textures

Les mots qui pilotent ce rendu : plat, aplats de couleur, sans dégradés, formes simples et audacieuses. Chaque mot compte. Retirez « sans dégradés » et vous verrez souvent des ombres douces s'immiscer.

Icône de style vectoriel

[SUBJECT] a single shield icon with a checkmark
[STYLE] minimal vector icon, uniform stroke weight, rounded line caps, two-tone, high contrast on plain background
[COMPOSITION] centered, icon fills most of the frame, square aspect
[CONSTRAINTS] no text, no background scenery, no gradients

Les prompts d'icônes gagnent à comporter des qualificatifs explicites — unique, épaisseur de trait uniforme — car sans eux, on obtient souvent une petite scène plutôt qu'un symbole graphique.

Illustration éditoriale

[SUBJECT] a person reviewing charts on a large screen
[STYLE] editorial illustration, muted palette, subtle grain, hand-drawn line quality, slightly abstracted human figures, magazine feature style
[COMPOSITION] subject offset to the right, breathing room on the left, landscape aspect
[CONSTRAINTS] no text in image, no photorealism, no logos

Le style éditorial occupe un entre-deux : plus texturé et personnel que le vectoriel plat, mais clairement pas de la photographie. L'association d'une palette sourde et d'un grain subtil est précisément ce qui l'empêche de glisser vers l'un ou l'autre extrême.

Conseil de réglage : ne changez qu'un adjectif de style à la fois. Remplacer « palette sourde » par « palette vive » est une vraie expérience ; changer cinq mots d'un coup n'en est pas une.

Fiches photographiques : réalisme, studio et cadrage lifestyle

Les fiches photographiques utilisent le même squelette, seul le vocabulaire change. Remarquez que le bloc sujet reste presque identique — c'est le bénéfice du modèle.

Photo produit studio propre

[SUBJECT] a ceramic coffee mug on a plain surface
[STYLE] professional studio product photography, soft diffused key light, gentle falloff, neutral background, sharp focus, realistic material detail
[COMPOSITION] centered, slight three-quarter angle, generous negative space above, square aspect
[CONSTRAINTS] no text in image, no props, no harsh reflections

Le vocabulaire photographique se regroupe autour de la lumière (diffuse douce, décroissance), de l'optique (mise au point nette, profondeur de champ) et du réalisme matériel (détail de matière réaliste). Le vocabulaire d'illustration se regroupe autour de la forme et du remplissage. Ce contraste constitue toute la différence entre les deux familles de fiches.

Lifestyle en situation

[SUBJECT] a person working at a wooden desk near a window
[STYLE] candid lifestyle photography, natural window light, shallow depth of field, warm neutral tones, realistic skin and fabric texture
[COMPOSITION] over-the-shoulder framing, subject left of center, landscape aspect
[CONSTRAINTS] no text in image, no visible brand marks, no exaggerated saturation

Sur le vif et lumière naturelle de fenêtre éloignent la sortie du poli du studio. Si le résultat paraît trop posé, c'est souvent autant un problème de composition que de style — ajouter « cadrage par-dessus l'épaule » aide davantage que d'empiler des adjectifs.

Convertir une fiche d'illustration en photographie

À partir d'une fiche d'illustration qui fonctionne, la conversion est mécanique :

1. Remplacez tout le bloc [STYLE] par du vocabulaire photographique.
2. Ajustez [COMPOSITION] uniquement si le cadrage diffère (l'angle compte davantage en photographie).
3. Gardez [SUBJECT] identique octet pour octet.
4. Conservez les éléments négatifs globaux ; retirez les éléments propres à l'illustration qui ne s'appliquent plus, comme « sans dégradés ».

Si le résultat photographique invente ou omet des éléments du sujet, le bloc sujet est probablement sous-décrit — corrigez à cet endroit plutôt que d'ajouter des mots de style compensatoires.

Contrôler la mise en page et le rendu du texte

La mise en page et le texte sont les deux choses que les développeurs s'attendent le plus souvent à voir le modèle deviner, et précisément les deux qui méritent le plus d'être explicitement écrites. Traitez-les comme des blocs de prompt distincts, séparés du style.

Un langage de position qui contraint réellement

Vague : « une image de bannière pour une landing page. »

Explicite :

[COMPOSITION] landscape 16:9 frame; subject occupies the right two-thirds;
left third is empty open space suitable for a headline; horizon line at
lower third; nothing enters the left third

Trois habitudes rendent les instructions de position plus solides :

• Nommez d'abord le cadre, puis décrivez le placement (« cadre paysage 16:9 »).
• Réservez explicitement une zone et déclarez que rien n'y entre. L'espace vide n'est pas l'état par défaut.
• Ancrez-vous sur les lignes de tiers, plutôt que sur des termes non mesurables comme « légèrement décentré ».

Rendu du texte

Lorsque vous voulez du texte dans l'image, isolez-le dans un bloc et citez la chaîne exacte :

[TEXT] render exactly the words "Ship faster" in a bold sans-serif,
placed in the reserved left third, vertically centered, single line,
high contrast against a plain background. No other text anywhere.

Points qui réduisent les itérations :

• Citez la chaîne littérale — ne la reformulez jamais dans le prompt.
• Dites « exactement » et « pas d'autre texte » — sinon des mots parasites apparaissent dans les coins ou sur les accessoires.
• Spécifiez le nombre de lignes (« une seule ligne »), sinon le retour à la ligne devient une devinette.
• Spécifiez un fond contrasté (« sur fond uni ») pour que le texte ait quelque chose sur quoi s'appuyer.
• Tenez le texte totalement à l'écart du bloc [STYLE] ; les mélanger rend les deux plus difficiles à régler.

Si une requête exige une composition typographique multi-éléments précise, traitez le texte généré comme un point de départ et prévoyez en aval une véritable couche de texte. Le contrôle du texte au niveau du prompt convient aux titres courts et aux étiquettes, pas au corps de texte dense.

Listes négatives : quoi exclure et comment versionner

La liste négative est votre outil de contrôle qualité le moins coûteux. Plutôt que de décrire ce que vous voulez, nommez les modes d'échec que vous refusez d'accepter.

Catégories à exclure

Organisez les éléments négatifs par catégorie, de sorte que vous puissiez les étendre sans créer de contradictions :

• Artefacts de texte — mots parasites, glyphes illisibles, filigranes, signatures.
• Artefacts de composition — sujet rogné, membres tronqués, éléments dupliqués, bords encombrés.
• Artefacts de rendu — flou, banding, sursaturation, sensation HDR agressive, peau en plastique.
• Hygiène de contenu — logos, marques déposées reconnaissables, portraits de personnes réelles.
• Dérive de style — photoréalisme dans une fiche d'illustration, aspect illustration dans une fiche photographique.

Cette dernière catégorie est celle que les équipes oublient le plus souvent. Si votre fiche d'illustration dérive constamment vers le réalisme, un élément négatif explicite est souvent plus fiable qu'un empilement d'adjectifs de style.

Rester concis et non contradictoire

Une liste négative trop longue se retourne contre vous. Si un élément négatif entre en conflit avec une instruction positive, le résultat devient instable et vous ne pouvez pas déterminer quelle clause l'emporte. Deux règles :

1. Ne niez jamais ce que vous avez demandé. Si le bloc composition demande des ombres pour la profondeur, n'inscrivez pas aussi « sans ombres » globalement.
2. Le spécifique avant le générique. « sans filigrane » est actionnable ; « pas de choses moches » est du bruit.

Versionner la liste négative avec le prompt

Les éléments négatifs modifient le comportement de chaque fiche qui les référence, ils ont donc besoin d'une traçabilité équivalente à celle des prompts :

{
  "negative_list_id": "global-v2",
  "entries": ["watermark", "signature", "stray text", "cropped subject", "duplicated elements", "oversaturated colors"]
}

Référencez cette liste par ID depuis chaque fiche, et incrémentez l'ID lors d'une modification. Quand la qualité des sorties dérive après déploiement, « la liste négative a-t-elle changé ? » devient une ligne à vérifier dans un diff, plutôt qu'une enquête.

Comparer avec de vraies sorties avant de livrer

Tant que vous n'avez pas examiné de vraies sorties, une fiche n'est qu'une hypothèse. Le processus de comparaison ci-dessous est délibérément léger — il devrait prendre quelques minutes, pas un sprint.

Processus

1. Gelez tout sauf une variable. Même bloc sujet, même composition, mêmes éléments négatifs, et si l'API expose une graine, même graine. Ne changez que le bloc de style.
2. Générez une petite matrice. Deux ou trois variantes de style croisées avec deux ou trois sujets représentatifs suffisent généralement à révéler une mauvaise fiche.
3. Évaluez côte à côte, pas séquentiellement. L'évaluation séquentielle favorise le biais de récence — la dernière image paraît la meilleure simplement parce qu'elle est la plus fraîche.
4. Notez selon le besoin, pas selon le goût. Notez par écrit à quoi sert l'asset (bannière héros, jeu d'icônes, en-tête éditorial) et vérifiez les propriétés concrètes qui importent : la zone réservée est-elle réellement vide, y a-t-il du texte parasite, y a-t-il une dérive de style.
5. Promeuvez consciemment. Seule une révision de fiche ayant passé la revue entre dans le code produit, avec son étiquette de version.

Ce sur quoi être attentif

• Cohérence entre sujets. Un bloc de style qui fonctionne sur un sujet et s'effondre sur un autre n'est pas prêt.
• Respect des contraintes. Le tiers gauche réservé est-il resté vide ? La chaîne exacte citée apparaît-elle une seule fois ?
• Agrégation des échecs. Si le même artefact apparaît dans plusieurs variantes, il doit entrer dans la liste négative, pas déclencher un ajustement fin du style.

Tout conserver dans le dépôt

Gardez ensemble le JSON de la fiche, les versions de la liste négative et les comptes rendus de revue. Quand quelqu'un demandera dans six mois pourquoi l'image héros ressemble à ça, la réponse sera un commit, pas un souvenir.

Une fois qu'une fiche a passé ce cycle, basculer entre illustration et photographie pour un sujet donné devient une modification d'un seul champ — précisément la caractéristique de maintenance que le squelette est conçu pour offrir. Exécutez ces fiches via une API unifiée pour la génération texte-image de Recraft v4.1, et versionnez chaque révision de prompt aux côtés du code qui l'appelle.