HiAPI
Blog

Guide d'utilisation

Recettes de prompts pour Flux-1 Kontext Max : des prompts d'édition prêts à copier-coller et réellement efficaces

Les formulations d'instructions que vous pouvez dès aujourd'hui coller dans Kontext Max, et comment itérer quand la première édition rate sa cible

Nov 3, 2026
Article cover: flat marbled liquid forms in celadon and slate folding over a dark ink field.

L'essence des recettes de prompts pour Kontext Max

Une recette de prompt n'est pas un texte descriptif — c'est un format d'instruction compact qui dit précisément au modèle quoi changer et quoi préserver. Pour Flux-1 Kontext Max, chaque recette fiable que nous utilisons suit la même structure en quatre parties :

  • Verbe — le type d'opération : remplacer, supprimer, recolorer, ajouter, étendre, restyliser.
  • Cible — la zone ou l'objet sur lequel le verbe agit, nommé explicitement (« la veste rouge portée par la personne à gauche »).
  • Changement souhaité — l'état final, pas le processus (« la transformer en bleu marine » plutôt que « changer la couleur »).
  • Clause de préservation — ce qui doit rester strictement identique (« conserve les mêmes plis du tissu, le même éclairage et le même arrière-plan »).

Une recette se lit donc ainsi : replace the jacket on the person at left with a navy wool coat; keep pose, lighting, and background unchanged.

Le modèle mental essentiel : Kontext Max est un éditeur, pas un générateur. Il part de votre image d'entrée et applique un différentiel (diff). Plus ce différentiel est petit et ses frontières précises, plus le résultat est prévisible. Les prompts qui se lisent comme des descriptions de génération d'image (« un portrait émotionnel d'une femme dans une ville la nuit ») donnent au modèle la liberté de tout régénérer — et il le fait.

La clause de préservation est la partie que la plupart des gens sautent, et c'est celle qui a le plus d'impact. Sans elle, le modèle considère le reste de l'image comme modifiable à volonté. Avec elle, vous dessinez en réalité un masque en langage naturel — ce qui est utile, car vous n'avez jamais à construire de masque manuellement.

La recette décompose le prompt en différents flux d'entrée qui se rejoignent en une seule étape d'édition.

Les règles de formulation qui changent le résultat

Voici les leviers que vous contrôlez au niveau du prompt. Chacun oriente de manière fiable la sortie dans une direction prévisible.

Utilisez l'impératif, pas le descriptif

Écrivez « supprime la poubelle dans le coin inférieur droit » plutôt que « il y a une poubelle qui ne devrait pas être là ». Le ton impératif correspond directement à l'opération d'édition. Le ton descriptif se lit comme une description de scène et invite à la régénération.

Nommez la cible, pas l'image entière

« Le panneau au-dessus de la porte » vaut mieux que « le texte dans l'image ». Si votre image contient trois panneaux, précisez lequel (« le panneau en bois suspendu au-dessus de l'embrasure de gauche »). Les ancres spatiales — gauche, droite, haut, premier plan, derrière le sujet — ne coûtent presque rien et éliminent la plupart des ambiguïtés.

Une seule édition par instruction

S'il faut deux changements, ne les enchaînez par des points-virgules que s'ils s'appliquent à la même zone : remove the chair; keep the floorboards and shadows beneath it. Les éditions sans rapport doivent faire l'objet d'appels séparés. Empiler des changements sans rapport dans un seul prompt est la cause la plus fréquente de dommages collatéraux.

Ordre : les contraintes avant le style

Placez les contraintes de préservation et de portée avant tout adjectif optionnel. Keep the background, wardrobe, and expression unchanged; restyle the lighting to soft window light fonctionne. En revanche, Restyle to soft cinematic lighting, keep background unchanged laisse le traitement cinématographique déborder sur toute l'image. Le modèle considère ce qu'il lit en dernier comme le cadre de référence dominant, alors terminez par ce qui ne doit pas bouger.

Énoncez l'état final, pas les étapes

« Rends le ciel couvert, avec des nuages gris uniformes » est un objectif. « Désature, ajoute des nuages, baisse le contraste » est un enchaînement de tâches que le modèle n'exécutera pas littéralement et risque de surappliquer. Décrivez le résultat que vous voulez voir.

Évitez la négation quand une cible positive existe

« Supprime le filigrane » fonctionne, car la suppression est l'opération elle-même. Mais « ne le rends pas flou » est plus faible que « garde le sujet net et au point ». Exprimez les contraintes comme des invariants positifs dans la mesure du possible.

Restez bref

Une recette de plus de deux phrases dilue l'instruction. Si votre prompt a besoin d'un paragraphe entier, vous avez probablement deux éditions, ou une cible insuffisamment spécifiée.

Recettes prêtes à copier-coller pour les éditions courantes

Chaque recette ci-dessous peut être collée telle quelle. Remplacez les parties entre crochets par votre situation. L'explication du raisonnement montre pourquoi la formulation est construite ainsi — inspirez-vous du schéma, pas seulement du texte.

Remplacement d'objet

replace the [object] at [spatial anchor] with [new object]; keep the surrounding [key surface, e.g. table/floor] and lighting unchanged Raisonnement : l'ancre et la clause de préservation rendent la composition crédible. Nommer la surface environnante empêche le modèle de restituer le contexte différemment.

Suppression d'objet

remove the [object] at [spatial anchor]; reconstruct the background behind it to match the surrounding [surface] and fill the shadow naturally Raisonnement : une suppression exige de préciser ce qui prend sa place. Sans « reconstruis l'arrière-plan », vous obtenez souvent une tache ou une zone de remplissage discordante.

Remplacement d'arrière-plan

replace the background with [new setting]; keep the subject's silhouette, edge detail, and lighting direction identical Raisonnement : les détails de contour et la direction de l'éclairage sont les points où le remplacement d'arrière-plan échoue. Les nommer explicitement permet de les préserver.

Édition du texte d'un panneau

change the text on the [sign/label] to read "[new text]"; keep the font weight, perspective, and material of the sign unchanged Raisonnement : une cible courte et non ambiguë, plus un verrouillage de la perspective typographique. Le nouveau texte doit rester court — les chaînes longues sont précisément là où apparaissent les artefacts.

Changement de couleur et de matière

recolor the [object] to [color]; preserve the original texture, folds, and highlight placement Raisonnement : « recolor » plutôt que « change la couleur en » rend l'instruction plus compacte, et la clause sur la texture empêche un remplissage à plat.

Outpainting / extension

extend the image to the [left/right/top] by roughly [fraction, e.g. one third]; continue the existing [surface, e.g. wall/ground] seamlessly and match the current lighting Raisonnement : nommer la surface à prolonger et l'éclairage à assortir est précisément ce qui distingue une extension propre d'une couture visible.

Retouche de pose ou d'expression

adjust the subject's expression to a slight smile; keep head angle, hair, and the rest of the face unchanged Raisonnement : « le reste du visage inchangé » est le garde-fou. Sans encadrer les traits voisins, les éditions du visage dérivent.

Restylisation avec limitation de portée

apply a [style, e.g. watercolor] treatment to the foreground subject only; leave the background photographic and unchanged Raisonnement : les prompts de restylisation sont la première source de sur-application. Limiter la portée du style est obligatoire, pas optionnel.

Chaque recette associe la formulation à la portée de l'édition : du micro-ajustement local au réagencement complet d'une même forme liquide.

Intégrer les recettes à votre code

Une recette n'est qu'une chaîne de caractères — traitez-la comme telle dans votre base de code, avec des paramètres et une version.

Paramétrez, ne concaténez pas

Stockez les recettes sous forme de gabarits à emplacements nommés, remplis au moment de l'appel :

RECIPES = {
    "object_replace": "replace the {object} at {anchor} with {replacement}; "
                      "keep the surrounding {surface} and lighting unchanged",
    "object_remove": "remove the {object} at {anchor}; reconstruct the background "
                     "behind it to match the surrounding {surface} and fill the shadow naturally",
}

def build(recipe_key, **slots):
    return RECIPES[recipe_key].format(**slots)

Cela maintient la formulation stable sur des milliers d'images. Si une recette doit être ajustée, vous modifiez une seule chaîne au lieu d'une centaine de points d'appel.

Gardez l'image d'entrée fixe pour chaque comparaison

Lorsque vous ajustez une recette, réutilisez une image de référence. Si vous changez à la fois le prompt et l'image d'entrée, vous ne pouvez attribuer la différence à aucun des deux.

Validez les emplacements avant l'appel

Une ancre vide est pire qu'une ancre erronée — elle élargit silencieusement la portée de l'édition. Vérifiez que chaque emplacement est rempli et que les emplacements en texte libre (comme le nouveau texte d'un panneau) restent courts.

Une seule édition par requête

Comme les éditions de Kontext Max se font appel par appel, modélisez votre pipeline comme une série d'étapes d'édition, chacune avec sa propre recette et ses paramètres, plutôt qu'un prompt géant. Un petit exécuteur d'étapes qui applique les recettes dans l'ordre est bien plus facile à déboguer qu'une instruction unique et tentaculaire.

Journalisez le prompt rendu

Enregistrez le prompt rempli avec la référence de sortie et la version de la recette. Lorsque la qualité de sortie change, vous devez savoir si c'est la formulation qui a changé ou le comportement du modèle.

Que faire quand le résultat de l'édition est incorrect

La plupart des échecs se rangent en trois catégories. Diagnostiquez d'abord le symptôme, puis appliquez la correction correspondante.

Symptôme : la cible est totalement ratée

L'édition se produit ailleurs, ou aucun changement n'est visible.

  • Élargissez et affinez l'ancre : « le panneau au-dessus de la porte » → « le panneau en bois suspendu au-dessus de l'embrasure de gauche ».
  • Si l'objet est petit, précisez-le : « la petite étiquette dans le coin inférieur droit ».
  • Si le modèle a modifié un objet similaire, ajoutez une désambiguïsation : « le plus à gauche des deux panneaux ».

Symptôme : sur-édition

Vous n'avez demandé qu'un changement, le modèle en a fait trois.

  • Ajoutez ou renforcez la clause de préservation : nommez les éléments exacts qui doivent rester intacts (« conserve la pose, les vêtements et l'arrière-plan inchangés »).
  • Déplacez les contraintes après l'instruction de changement, ou répétez-les à la fin — la position compte.
  • Séparez les prompts empilés en appels distincts.

Symptôme : dérive

L'idée est bonne, mais l'image environnante a bougé — couleurs, éclairage ou détails se sont déplacés.

  • Transformez les exigences de préservation vagues en invariants concrets : n'écrivez pas « garde la même chose », mais « conserve la balance des blancs d'origine, la direction des ombres et la texture du tissu ».
  • Vérifiez si les adjectifs de style débordent ; limitez leur portée (« premier plan uniquement »).
  • Réduisez l'instruction à sa forme minimale et retestez sur l'image de référence.

La boucle

Exécutez la recette → classez l'échec en cible ratée, sur-édition ou dérive → appliquez la correction unique correspondante → relancez sur la même entrée de référence. Ne changez qu'une variable à chaque itération. Si vous en changez deux à la fois, vous ne saurez pas laquelle a fait la différence.

Tenez un court journal des échecs : version de la recette, prompt rempli, symptôme, correction, conclusion. Après quelques projets, ce journal aura plus de valeur que n'importe quel prompt isolé.

La boucle de débogage, du symptôme à la correction : exécuter, classer l'échec, ajuster la formulation, relancer.

Construisez votre propre bibliothèque de recettes

Les équipes qui obtiennent des résultats stables avec Kontext Max n'écrivent pas de meilleurs prompts jetables — elles maintiennent un petit ensemble de prompts éprouvés et versionnés.

Versionnez explicitement les recettes

Donnez à chaque recette une clé et une version (object_replace@v2). Quand vous changez la formulation, incrémentez la version et gardez l'ancienne disponible. De minuscules changements de formulation produisent des sorties nettement différentes, donc une bibliothèque de prompts sans gestion de versions est une source de régressions silencieuses.

Testez sur une suite fixe

Maintenez un petit ensemble d'images d'entrée fixes et d'éditions attendues connues — un remplacement, une suppression, un remplacement d'arrière-plan, une édition de panneau. Faites tourner cette suite à chaque changement de recette. Vous vérifiez deux choses : la cible a-t-elle été éditée, et l'image environnante est-elle restée inchangée. Une recette excellente sur le premier point mais en échec sur le second n'est pas prête.

Comparez les recettes, ne devinez pas

Quand deux formulations semblent toutes deux plausibles, exécutez les deux sur la même entrée de référence et gardez celle qui respecte la clause de préservation. Comparer coûte peu ; refaire une série d'images éditées coûte cher.

Laissez la bibliothèque s'enrichir naturellement

Commencez par les huit schémas ci-dessus. Quand un coéquipier résout un nouveau cas d'édition, ajoutez-le en expliquant pourquoi cette formulation fonctionne. Avec le temps, cette bibliothèque devient la documentation implicite d'ingénierie de prompts de votre équipe — et le matériel d'introduction pour quiconque découvre l'API.

Dépréciez plutôt que supprimer

La fenêtre de contexte de votre propre mémoire est courte. Une recette qui échoue sur un type d'image peut convenir parfaitement à un autre. Archivez les recettes retirées en notant pourquoi elles ont été abandonnées, afin que la personne suivante ne répète pas l'erreur.

Traitez les prompts comme du code : versionnez, testez, relisez, réutilisez. C'est cette discipline qui fait passer Flux-1 Kontext Max d'une démonstration à un maillon fiable de votre pipeline.

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