Recettes de prompts pour imagen4-fast : prompts copiables-collables pour développeurs

Pourquoi les recettes de prompts valent mieux que les prompts jetables

La plupart des problèmes de génération d'images ne viennent pas du modèle mais du prompt, et ils sont difficiles à corriger, car le prompt n'existe souvent que dans l'historique de chat de quelqu'un ou dans un document obsolète. Un prompt jetable qui a produit d'excellents résultats un mardi devient irreproductible le vendredi, parce que vous ne pouvez pas dire précisément ce qu'il contenait.

Une recette de prompt résout ce problème de la même manière qu'une fonction résout la logique copiée-collée. Elle a une structure fixe, des emplacements nommés et un identifiant stable, ce qui facilite les références ultérieures. Quand la sortie change, vous avez un point de comparaison.

Les bénéfices concrets apparaissent vite :

• Cohérence entre les appels. La même recette avec les mêmes entrées produit des compositions et des styles comparables ; c'est essentiel quand une page doit afficher douze vignettes dans une grille.
• Itération à moindre coût. Vous modifiez un emplacement à la fois au lieu de réécrire une prose libre, et vous ne perdez pas ce qui fonctionnait déjà.
• Traçabilité. Les recettes ont des versions. Quand l'équipe de marque demande pourquoi les vignettes paraissent plus plates que le mois dernier, vous pouvez faire une recherche par dichotomie.
• Révisabilité. Une recette se révise dans une pull request comme n'importe quelle autre ressource, sans que le relecteur ait besoin de gagner sa vie en écrivant des prompts.

Le reste de cet article est un manuel. Chaque recette suit le même squelette, ce qui vous permet d'en lire une, de l'adapter, puis de l'intégrer à votre base de code sans refactorisation. Traitez le modèle comme un composant, et la recette comme l'interface que vous construisez par-dessus.

Une idée à garder en tête : une recette n'est pas une formule magique. C'est un contrat entre un emplacement d'interface en aval et l'appel de génération. L'emplacement d'interface détermine le cadre ; la recette détermine avec quoi le remplir.

Le squelette de prompt de base

Chaque recette de ce manuel est construite sur le même squelette en quatre parties. Copiez ceci et remplissez les emplacements :

[subject] — [composition] — [style] — [constraints]

C'est tout l'essentiel. Voici une version remplie, prête à coller :

A lone ceramic coffee cup on a pale oak desk, three-quarter view, shallow depth of field,
soft morning light from the left, minimal editorial product photography, muted warm palette,
no text, no logos, no hands, centered subject with breathing room on all sides

Le rôle de chaque emplacement

Le sujet (Subject) est l'unique chose dont parle l'image. Nommez-le précisément : « une tasse à café en céramique », pas « une ambiance café ». Si le sujet a une action ou un état, placez-la ici aussi : « un développeur au clavier, en plein travail devant un bureau plongé dans la pénombre ». Résistez à l'envie d'ajouter un deuxième sujet ; c'est la cause la plus fréquente de résultats confus.

La composition (Composition) contrôle le cadre. L'angle de vue (vue de trois quarts, plongée, à hauteur des yeux), la position du sujet (centré, à gauche selon la règle des tiers), le cadrage (plein cadre, cadrage serré) et la profondeur de champ relèvent de cet emplacement. C'est là que vous encodez l'intention de ratio d'aspect dans le texte, même si le ratio réel est un paramètre distinct.

Le style (Style) est un court lexique visuel : le médium (photo, vecteur plat, aquarelle), la lumière (lumière douce du matin, contre-jour dur), la palette (tons chauds atténués, monochrome à fort contraste) et la texture (mat, brillant, granuleux). Tenez-vous-en à une à trois courtes phrases. Les blocs de style plus longs ont tendance à se contrarier mutuellement.

Les contraintes (Constraints) sont l'espace négatif. Ce qui ne doit pas apparaître : texte, logos, filigranes, membres supplémentaires, arrière-plan encombré, ombres dures. Les contraintes sont une assurance peu coûteuse, et la première chose à étendre quand une recette dysfonctionne.

Deux variantes à garder sous la main

Photo d'objet minimaliste :

[object] on a seamless [color] backdrop, centered, straight-on view, soft even studio light,
clean commercial product photography, no shadows on background, no text, no props

Photo de scène éditoriale :

[scene subject] in [environment], wide establishing view, natural light, subtle film grain,
documentary photography, muted palette, no text, no logos, no visible brand marks

Les deux restent délibérément courtes. Si votre prompt est un empilement d'adjectifs, vous avez probablement perdu l'emplacement de composition quelque part à l'intérieur.

Choisir le ratio d'aspect avant d'écrire le prompt

Écrivez le prompt après avoir compris la forme du trou à remplir. Le ratio d'aspect est une décision produit, pas une décision de prompt ; le choisir tard vous force à réécrire une phrase de composition déjà réglée.

Une correspondance simple qui couvre la plupart des interfaces :

• Bannières principales et en-têtes de page — cadre large. Vocabulaire de composition : « wide establishing view », « horizon placed in the lower third », « negative space on the left for headline overlay ».
• Cartes et tuiles de grille — carré ou presque carré. Vocabulaire de composition : « centered subject », « even margins », « no important detail near the edges ».
• Avatars et petites images de profil — carré, cadrage serré, sujet unique. Vocabulaire de composition : « head and shoulders », « centered face », « plain background ».
• Vignettes et lignes de liste — petit cadrage large ou carré, le sujet doit rester reconnaissable une fois réduit. Vocabulaire de composition : « single dominant subject », « high contrast against background », « no fine detail ».
• Contenu éditorial ou illustrations d'articles longs — cadre vertical. Vocabulaire de composition : « vertical composition », « subject occupies the upper two thirds », « foreground anchor at the bottom ».

Pourquoi la formulation doit correspondre au cadre

Une phrase de composition écrite pour une bannière large (« negative space on the left ») n'a plus aucun sens une fois recadrée en carré ; et un cadrage vertical serré décrit en texte sera comprimé si vous demandez un cadre large. Le prompt et le ratio doivent s'accorder, car vous décrivez deux fois le même rectangle : une fois en langage, une fois en paramètre.

Flux de travail pratique

1. Examinez l'emplacement d'interface réel, notez son ratio d'aspect et la façon dont il est recadré sur petits écrans.
2. Choisissez le ratio d'aspect pris en charge le plus proche, plutôt que de demander au modèle de simuler des marges.
3. Écrivez l'emplacement de composition autour de ce cadre, y compris où doit se trouver l'espace négatif.
4. Après génération, vérifiez le pire recadrage possible (mobile, réduction en grille), pas le cas idéal.

Si une recette doit servir deux emplacements très différents, faites deux recettes. Dupliquer une recette coûte moins cher que d'écrire une phrase de composition qui fonctionne à moitié partout.

Des blocs d'indices de style interchangeables selon l'interface

L'emplacement de style est la partie que vous devez vous attendre à modifier le plus souvent ; rendez-le donc modulaire. Écrivez les indices de style sous forme de bloc autonome, attaché au squelette de base, et conservez un bloc par interface ou par tonalité de marque.

Sûr pour la marque / neutre

minimal editorial photography, soft diffused light, muted neutral palette,
clean background, product-focused, no text, no logos

Pour les pages marketing, où l'image ne doit ni rivaliser avec le texte ni suggérer une promesse de marque.

Photographie / documentaire

natural light, documentary photography, shallow depth of field, subtle grain,
unposed subject, realistic color, no heavy filters

Pour les illustrations éditoriales et les interfaces narratives, où le réalisme compte plus que le poli.

Illustration plate

flat vector illustration, limited two-color palette, bold simple shapes,
no gradients, generous whitespace, geometric composition, no text

Pour l'onboarding, les états vides et la documentation, où l'image doit s'accorder au système de design.

Photo produit en studio

seamless studio backdrop, soft even key light, crisp shadows, high detail on the subject,
commercial catalog photography, no props, no text

Pour les catalogues de produits et les grilles de comparaison, où la cohérence entre plusieurs images prime sur n'importe quelle image isolée.

Comment changer de bloc sans dégrader

• Traitez le bloc de style comme une variable, jamais entrelacée avec les phrases de sujet ou de composition. Si les mots de style sont dispersés dans le prompt, vous ne pouvez pas les remplacer proprement.
• Ne changez qu'un bloc à la fois et régénérez le même sujet et la même composition. Si deux variables bougent en même temps, vous ne saurez pas laquelle a causé le changement.
• Méfiez-vous des blocs de style qui glissent subrepticement de la composition. « Centered » et « close-up » relèvent de la composition, pas du style ; s'ils vivent dans le bloc de style, vos efforts sur le ratio d'aspect sont silencieusement annulés.
• Taillez les blocs qui gonflent. Trois courtes phrases de style suffisent généralement ; à cinq, elles commencent à se concurrencer.

Un test utile : remplacez le bloc de style sur une recette par ailleurs identique et voyez si la sortie s'adapte toujours au même emplacement d'interface. Si oui, le bloc est bien isolé.

Paramétrer les prompts dans le code

Les recettes doivent exister sous forme de modèles, et non de littéraux de chaîne éparpillés dans les gestionnaires. Un modèle à variables nommées vous offre gratuitement les tests A/B, les retours arrière et les surcharges par interface.

Forme du modèle

RECIPE = {
    "id": "product-hero-v3",
    "template": (
        "{subject} — {composition} — {style} — {constraints}"
    ),
    "defaults": {
        "composition": "centered subject, generous margins, eye-level view",
        "style": "minimal editorial photography, soft diffused light, muted neutral palette",
        "constraints": "no text, no logos, no watermark, clean background",
    },
    "aspect_ratio": "1:1",
}


def render(recipe, **overrides):
    slots = {**recipe["defaults"], **overrides}
    return recipe["template"].format(**slots)

L'objet recette porte son identifiant (id), son cadre (aspect_ratio) et ses valeurs par défaut. L'appelant ne fournit que les parties qui diffèrent. Cela garde le point d'appel court et rend la différence entre deux interfaces immédiatement visible.

Variantes pour les tests A/B

Modélisez les variantes comme des surcharges de la recette de base, et non comme des chaînes bifurquées :

variants = {
    "control": {},
    "warm": {"style": "minimal editorial photography, warm afternoon light, muted warm palette"},
    "tight": {"composition": "tight crop, subject fills the frame, eye-level view"},
}

Comme chaque variante partage le sujet et les contraintes, la différence de résultat peut être attribuée à l'emplacement que vous avez modifié. C'est là toute la valeur de l'exercice.

Retour arrière et épinglage

• Donnez un numéro de version à chaque recette dans id et journalisez-le à chaque requête de génération. Quand la sortie change, le journal vous dit quelle version de recette a produit quoi.
• Gardez les anciennes versions adressables pendant un certain temps. Un retour arrière doit être un changement de configuration, pas un retour de code sous pression.
• Transmettez l'identifiant de recette à votre système d'analyse, et non la chaîne rendue, afin de regrouper les résultats par recette plutôt que par texte de prompt exact.
• Validez les emplacements avant d'appeler l'API : un subject vide doit échouer rapidement dans votre application, plutôt que de produire une image vague.

Traitez le ratio d'aspect comme un paramètre de premier ordre à côté du modèle, car il est déterminé par l'emplacement d'interface et non par le texte du prompt. Tout ce dont l'API a besoin doit dériver d'un objet recette, pour que chaque interface ait une source de vérité unique.

Modes de défaillance courants et méthode de débogage

La plupart des sorties médiocres remontent à un seul emplacement. Utilisez cette liste pour décider quelle partie du squelette ajuster avant de réécrire tout le prompt.

Le sujet est coupé ou sort du cadre

Symptômes : tête rognée, objet qui déborde du bord, détail important hors de la zone de sécurité.

Corrigez d'abord l'emplacement composition, pas le style. Ajoutez un vocabulaire de cadrage explicite (« full subject in frame », « generous margins on all sides ») et vérifiez que le ratio d'aspect correspond au cadre prévu. Si le sujet est intrinsèquement haut et l'emplacement large, c'est le cadre qui est faux, pas le prompt.

Résultats encombrés

Symptômes : plusieurs points focaux concurrents, arrière-plan chargé, accessoires que vous n'aviez pas demandés.

Corrigez l'emplacement sujet. Réduisez à un sujet, un état. Déplacez dans les contraintes, en tant qu'exclusions, tout ce qui pourrait être lu comme un accessoire. L'encombrement vient généralement d'un sujet vague, pas d'un modèle trop zélé.

Style incohérent dans un même lot

Symptômes : certaines images de la grille ressemblent à des photos, d'autres à des illustrations ; la palette dérive.

Corrigez le bloc style. Raccourcissez-le à un médium, une courte phrase de lumière, une courte phrase de palette. Retirez les mots de style qui débordent dans d'autres emplacements et scindez les recettes qui servent deux interfaces distinctes. Une incohérence dans un lot est souvent le symptôme d'un bloc de style qui diffère à chaque appel.

Apparition de texte ou de logos

Symptômes : lettres illisibles, faux filigranes, marques ressemblant à des logos.

Étendez les contraintes : « no text, no lettering, no logos, no watermarks, no signage ». Si la composition suggère un support qui porte habituellement du texte (écran, emballage, affiche), soit vous le précisez explicitement, soit vous changez la composition.

La sortie ignore l'émotion demandée

Symptômes : l'image est correcte mais paraît plate, rigide ou générique.

Corrigez le bloc style, une courte phrase à la fois. La lumière est généralement le changement le plus efficace ; la palette vient ensuite. Régénérez avec le même sujet et la même composition, pour que la comparaison soit honnête.

Tous les autres cas

Si deux emplacements semblent suspects, changez-en un et régénérez. Si le résultat reste faux, prenez du recul et vérifiez si la recette est sommée de servir un emplacement d'interface pour lequel elle n'a jamais été écrite : c'est une inadéquation produit, pas un défaut de prompt.

Publier une bibliothèque de recettes

Une fois que les recettes sont des modèles versionnés, elles deviennent un actif que l'équipe maintient avec le code. L'objectif est que n'importe qui puisse trouver la recette derrière une interface, comprendre pourquoi elle est ainsi faite et la modifier en toute sécurité.

Organiser par interface, pas par texte de prompt

Groupez les recettes selon leur lieu de rendu : hero, card, avatar, thumbnail, editorial-figure. Un développeur qui regarde la page de tarifs doit atterrir sur la recette utilisée par cette page, pas sur une liste d'adjectifs classés alphabétiquement. Donnez à chaque recette un identifiant stable avec suffixe de version, et gardez les valeurs par défaut à l'intérieur de l'objet recette.

Réviser les recettes en pull request

Traitez les modifications de recette comme des modifications de composant. Le diff doit montrer quel emplacement a bougé et pourquoi. Les relecteurs peuvent poser des questions utiles : la composition correspond-elle encore au cadre, des mots de style ont-ils fui dans la composition, les contraintes ont-elles rétréci ? Les petits diffs portant sur un seul emplacement sont faciles à réviser ; les réécritures complètes, non.

Versionner, journaliser et nettoyer

• Journalisez l'identifiant et la version de la recette à chaque requête de génération, pour que les changements de sortie soient traçables jusqu'à une modification.
• Gardez les versions obsolètes adressables jusqu'à ce qu'aucune interface ne les référence, puis retirez-les en une seule passe de nettoyage, plutôt que de laisser des recettes mortes traîner indéfiniment.
• Quand vous ajoutez des variantes, promouvez la gagnante en nouvelle version au lieu de laisser la branche A/B comme chemin permanent.

Documenter le contrat

Pour chaque recette, documentez l'emplacement d'interface attendu, le ratio d'aspect et les contraintes à ne jamais supprimer. Deux phrases suffisent. La prochaine personne qui touchera cette recette doit savoir ce qu'elle n'a pas le droit de casser.

Garder la boucle courte

Une recette se dégrade quand personne ne la régénère après un changement de design. Intégrez une petite étape de révision à tout travail d'interface qui modifie un emplacement d'image, et relancez les recettes concernées dans le cadre de cette modification. Le système ne reste peu coûteux que si la boucle de retour reste courte.

Commencez par le squelette de base, ajoutez un bloc de style par interface, et laissez la bibliothèque de recettes croître à partir d'emplacements réels plutôt qu'hypothétiques. Si vous intégrez la génération dans une application, gardez les points d'appel légers et laissez l'objet recette porter les décisions.