HiAPI
Blog

Guide d'utilisation

Invites gpt-image-2.5-sunburst : des recettes texte-vers-image prêtes à copier-coller pour les développeurs

Oct 31, 2026
封面图:若干微微错位的骨白色纸张层叠如印刷套准偏移,中间夹入一张锈红色纸页,配扁平投影。

La structure de ces recettes d'invites

Chaque recette de cet article suit la même structure à cinq champs. Une fois que vous avez repéré le schéma, vous pouvez lire n'importe quelle invite de cet article comme une signature de fonction : chaque champ est une entrée nommée avec un rôle précis, changez-en une et la sortie changera de manière prévisible.

  • subject (sujet) — la chose concrète représentée. Restez précis et unique. « une bouteille en céramique mate » vaut mieux que « un produit », car cela élimine pour le modèle toute une catégorie de décisions à prendre.
  • style (style) — le langage de rendu : vecteur plat, rendu 3D doux, trait éditorial, photographie. Les mots de style se cumulent, donc deux suffisent généralement, et à partir de cinq ils commencent à entrer en conflit.
  • composition (composition) — l'emplacement du sujet et l'espace qu'il occupe. Centré avec de l'espace négatif, décentré, carrelé, pleine page. C'est le champ qui contrôle la mise en page de la manière la plus fiable, plus que tout autre.
  • lighting (éclairage) — direction, douceur et contraste. « lumière directionnelle douce venant du haut à gauche » est une instruction utilisable ; « un bon éclairage » ne l'est pas.
  • constraints (contraintes) — les garde-fous. Ce qui ne doit pas apparaître, ce qui doit rester lisible, quelle plage de couleurs est autorisée. Les contraintes sont le champ que le plus grand nombre de personnes sautent, et c'est aussi le champ qui rend une invite réutilisable.

Écrit sous forme de modèle, cela ressemble à ceci :

{subject}, {style}, {composition}, {lighting}, {constraints}

La valeur de cette structure ne tient pas à l'esthétique. Elle tient au fait que chaque champ devient une variable que vous pouvez remplir par programme, comparer entre versions et soumettre à des tests de régression d'un appel à l'autre. Une chaîne d'invite jetable est un nombre magique ; un modèle à cinq champs est un schéma.

Lorsque vous rédigez vos propres recettes, gardez l'ordre des champs stable. En pratique, le modèle accorde plus de poids aux tokens du début, et un ordre cohérent signifie que les variations de sortie peuvent être attribuées aux variables que vous avez réellement modifiées, et non à un ordre d'invite bousculé.

Chaque recette est une feuille de papier divisée en cinq champs décalés : sujet, style, composition, éclairage et contraintes.

Mettre en place un flux de travail de recettes prêtes à copier-coller

Ce flux de travail est volontairement ennuyeux : modèle, remplissage, appel, stockage. C'est cette platitude qui rend la génération d'images suffisamment reproductible pour être mise en production.

1. Stocker le modèle, pas la chaîne

Enregistrez chaque recette sous forme de modèle avec des espaces réservés nommés. Ne collez pas l'invite finale directement dans le code d'appel — sinon, lorsque vous voudrez la modifier plus tard, il faudra faire de l'archéologie pour la retrouver.

template = (
    "{subject}, {style}, {composition}, {lighting}, {constraints}"
)

def build_prompt(**kwargs):
    return template.format(**kwargs)

2. Remplir les variables à partir d'un dictionnaire

Traitez l'ensemble des variables comme des données. Ainsi, une même recette peut générer un ensemble d'images à partir d'un fichier de configuration ou d'une ligne de base de données.

recipe = {
    "subject": "a single matte ceramic bottle with a minimalist label",
    "style": "clean product photography, soft 3D render",
    "composition": "centered, generous negative space on the right",
    "lighting": "soft directional light from upper left, gentle falloff",
    "constraints": "no text artifacts, no clutter, neutral background",
}

prompt = build_prompt(**recipe)

3. Appeler le point de terminaison

Via l'interface unifiée HiAPI.ai, envoyez l'invite assemblée à gpt-image-2.5-sunburst/text-to-image. Placez les paramètres de requête (taille, format, nombre) dans le même objet de configuration que les variables, afin qu'un seul enregistrement décrive une génération complète.

4. Journaliser l'entrée complète, pas seulement la sortie

Conservez durablement l'invite remplie, la version de la recette et le jeu de paramètres avec chaque image renvoyée. Si, trois semaines plus tard, la sortie semble incorrecte, le journal vous dira si c'est l'invite qui a changé ou le modèle.

Ce cycle en quatre étapes constitue tout le système. Le reste de cet article n'est qu'un ensemble de recettes à brancher sur ce système.

Du modèle de recette au remplissage des variables, puis à l'appel reproductible et à l'image renvoyée — le flux de travail représenté par des piles de feuilles décalées.

Recette 1 : visuel principal de style produit

C'est la recette de référence pour les pages d'atterrissage, les en-têtes de documentation et les tuiles de boutique. Elle fonctionne parce que le champ composition gère la mise en page et que le champ contraintes garantit l'espace nécessaire pour le titre.

Invite

{subject}, clean product photography with soft 3D render finish,
centered subject with generous negative space on the right,
soft directional light from upper left with gentle falloff,
neutral seamless background, no text artifacts, no clutter, no harsh shadows

Un exemple rempli :

a single matte ceramic bottle with a minimalist label, clean product
photography with soft 3D render finish, centered subject with generous
negative space on the right, soft directional light from upper left with
gentle falloff, neutral seamless background, no text artifacts, no
clutter, no harsh shadows

Ce que montrent les sorties réelles

En pratique, cette recette place le sujet près du centre et réserve une zone de fond claire et nette sur la droite — utilisable directement pour superposer un titre, sans retouche. L'éclairage se lit comme une source douce unique plutôt qu'une lumière ambiante plate, ce qui donne au côté éclairé de l'objet un contour net, tandis que l'autre côté se fond doucement dans l'ombre.

Les mots de contrainte jouent ici un rôle mesurable. Sans « no text artifacts », l'étiquette a tendance à faire apparaître des lettres de nulle part ; avec, l'étiquette reste abstraite. Sans « no harsh shadows », l'atténuation se resserre pour se rapprocher d'une lumière dure de studio. Les deux variations sont visibles, et ce sont exactement le type de régressions que vous voulez détecter avant la mise en page.

Varier en toute sécurité

Vous pouvez librement remplacer subject — bouteille, casque, boîte, appareil conservent tous la composition. Ne touchez pas à composition et à lighting sauf si vous avez une raison de mise en page précise ; ces deux champs sont ce qui permet à la sortie d'entrer directement dans le modèle sans être redessinée.

La forme brute de la recette de visuel principal : un sujet centré, une source lumineuse maîtrisée et un espace négatif volontairement laissé vide.

Recette 2 : illustration éditoriale à palette cohérente

C'est dans la recette éditoriale que la variable de palette prend toute sa valeur. L'objectif est une illustration qui ressemble à une pièce d'une série — une douzaine d'articles partageant la même famille visuelle — sans avoir à tout régénérer depuis zéro à chaque fois.

Invite

{subject}, flat editorial illustration with subtle line texture,
{composition}, limited palette of {palette},
soft even lighting with no dramatic shadows,
no gradients, no photorealism, no text elements

Un exemple rempli :

an abstract diagram of connected ideas, flat editorial illustration with
subtle line texture, centered composition with breathing room around the
edge, limited palette of deep teal, warm sand, and off-white, soft even
lighting with no dramatic shadows, no gradients, no photorealism, no
text elements

Le comportement de la variable de palette

Nommer deux ou trois couleurs plus une couleur neutre permet de rester cohérent de manière stable. La sortie respecte les teintes nommées comme dominante colorée et utilise le neutre comme couleur de fond, ce qui est précisément ce qui maintient la cohérence de la série.

Deux modes d'échec apparaissent dans les sorties réelles. Premièrement, nommer cinq couleurs ou plus produit un effet plus proche de l'arc-en-ciel — la palette ne se lit plus comme limitée, et l'illustration perd sa retenue éditoriale. Deuxièmement, si vous omettez complètement la couleur neutre (« bleu profond et sable chaud » et rien d'autre), le fond se remplit souvent de l'une des deux couleurs d'accent, ce qui aplatit le contraste recherché.

La discipline de série

Figez style et constraints sur toute la série, ne variez que subject, et occasionnellement composition. Quand un nouvel article a besoin de sa propre illustration, vous ne changez qu'un champ et obtenez un frère plutôt qu'un étranger. C'est tout le sens de la recette : la cohérence visuelle est un sous-produit de la discipline des paramètres, et non une tâche de direction artistique à répéter chaque semaine.

Recette 3 : motif d'arrière-plan adapté à l'interface utilisateur

La texture d'arrière-plan est la recette la plus discrète, et aussi celle qui pose le plus souvent problème en production, car une texture qui semble correcte isolément peut ruiner la lisibilité du texte dès qu'elle se retrouve derrière un paragraphe.

Invite

{subject}, subtle abstract texture pattern, {scale} scale repetition,
low contrast with soft tonal variation, muted palette of {palette},
even flat lighting, no focal point, no text, no high-frequency detail,
keeps center area clear and low-contrast for text overlay

Un exemple rempli :

organic flowing line shapes, subtle abstract texture pattern, medium
scale repetition, low contrast with soft tonal variation, muted palette
of pale slate and warm grey, even flat lighting, no focal point, no
text, no high-frequency detail, keeps center area clear and low-contrast
for text overlay

Pourquoi les mots de contrainte sont importants

« no focal point » est l'expression porteuse. Sans elle, la texture a tendance à s'organiser autour d'une forme dominante au centre de l'image — précisément l'endroit où vous placez le titre. « no high-frequency detail » empêche quant à lui les petits motifs de devenir du bruit visuel derrière du texte de petite taille, en particulier sur les écrans à faible DPI.

La dernière proposition — garder le centre net et à faible contraste — est une contrainte de composition plutôt que de style. Elle repousse les parties les plus complexes du motif vers les bords, ce qui vous offre une zone protégée pour le texte sans avoir besoin d'une couche de masque supplémentaire.

L'échelle comme variable

scale peut être modifié sans risque et change nettement la sensation de la texture. Une petite échelle se lit comme un grain de papier, adapté aux panneaux d'interface denses ; une grande échelle se lit comme un fond de double page éditorial, adapté aux en-têtes larges. Rendez deux fois avec les deux échelles, puis choisissez selon la surface, plutôt que de tenter de faire servir une seule image à tous les usages.

Remplacer les variables d'invite sans casser la sortie

Tous les champs n'ont pas la même importance. D'après les sorties réelles de ces recettes, voici une carte pratique des risques.

Remplacements à faible risque

  • subject — la variable à plus forte valeur, généralement sûre tant qu'elle reste dans la même catégorie. Remplacer une bouteille par un casque fonctionne ; remplacer une bouteille par une scène de foule ne fonctionne pas, car le champ composition a été écrit pour un objet unique centré.
  • palette (dans les limites) — vous pouvez changer librement les noms de couleurs, mais gardez un nombre de deux à trois plus un neutre.
  • scale — modifie le rendu sans casser la structure.

Remplacements à risque moyen

  • composition — passer d'une mise en page compatible à une autre (centré, décentré, carrelé) est sûr, mais chaque changement modifie la quantité d'espace négatif obtenue. Si le modèle en aval dépend d'une zone vide précise, vérifiez après modification.
  • lighting — un changement de direction se lit clairement et fonctionne généralement ; passer d'une lumière douce à une lumière dure change l'ambiance générale et peut entrer en conflit avec des mots de style comme « propre » ou « subtil ».

Remplacements à risque élevé

  • style — passer du vecteur plat à la photographie équivaut en pratique à une nouvelle recette. Les mots de composition et de contrainte ont été écrits pour un langage de rendu et ne sont souvent plus pertinents dans un autre.
  • constraints — supprimer une contrainte est la cause la plus fréquente d'une invite qui fonctionnait avant et produit désormais une sortie inutilisable. Traitez la modification d'une contrainte comme une modification de code : faites-le consciemment et revérifiez le résultat.

Une règle pratique

Lorsque vous avez besoin d'une nouvelle image, ne modifiez qu'un seul champ à la fois et comparez avec la sortie précédente. Si vous en modifiez deux, vous ne pouvez pas savoir lequel a causé la régression — la discipline de débogage que vous appliquez à tout autre système paramétré s'applique ici aussi, et c'est précisément ce qui distingue une bibliothèque d'invites utile d'une bibliothèque qui se dégrade silencieusement.

Évaluer et livrer les images générées

Avant qu'une image n'entre dans l'interface produit, passez-la au crible d'une courte liste de vérification fixe. Les critères doivent être identiques à chaque fois, afin que « conforme » ait le même sens d'un appel à l'autre, d'une recette à l'autre et d'un membre de l'équipe à l'autre.

La vérification en quatre points

  1. Respect des contraintes. La sortie respecte-t-elle réellement les clauses négatives ? Pas de texte apparu de nulle part, pas de point focal qui n'aurait pas dû exister, palette dans les limites nommées. C'est le premier filtre, car un échec de contrainte est le plus difficile à corriger en aval.
  2. Stabilité de la composition. Le sujet se trouve-t-il à l'endroit promis par la recette, avec l'espace négatif nécessaire à votre mise en page ? Si le modèle attend une zone claire à droite, mesurez-la, ne vous fiez pas à l'œil.
  3. Lisibilité en contexte. Pour tout élément placé derrière ou à côté de texte, faites une vérification par composition avec la taille de police et le texte réels. Les textures et illustrations qui passent isolément échouent souvent ici.
  4. Cohérence de série. Si cette image fait partie d'un ensemble, placez-la à côté de deux images sœurs. Même famille de palette, même épaisseur de trait, même niveau de détail. Une valeur aberrante nuit plus à l'ensemble qu'une image faible.

La discipline de livraison

Joignez la version de la recette, l'invite remplie et le jeu de paramètres à chaque image que vous conservez. Si la sortie semble incorrecte plus tard, vous pouvez rejouer exactement le même appel pour déterminer si l'entrée a dérivé ou si le comportement du modèle a changé — et vous pouvez régénérer toute une série à partir des recettes stockées, sans fouiller dans l'historique des conversations.

Le copier-coller est le fil conducteur de bout en bout : n'importe quel membre de l'équipe devrait pouvoir prendre une recette de cet article, remplir les variables et reproduire le résultat sans réajuster un seul mot. En construisant une bibliothèque d'invites de cette manière, la génération d'images cesse d'être une négociation image par image pour devenir un service que l'équipe appelle.

Articles similaires

Voir tous les articles →

Commencez avec des artefacts IA persistants

Obtenez votre clé API et appelez des modèles d'image, de vidéo et d'audio via une API unique basée sur les tasks.

Lire la documentation de l'API