Prompts d'édition d'images Seedream 5.0 Pro : 6 recettes prêtes à copier-coller et leurs sorties réelles

La génération à partir de texte a monopolisé les démos, mais le travail réellement exploitable — intégrer un visuel produit dans une scène, changer la tenue d'un mannequin, corriger une seule couleur récalcitrante sans toucher au reste — repose sur l'édition d'image.seedream-5.0-pro/image-to-image est la gamme Pro de la série Seedream 5.0 de ByteDance, et sa capacité phare est l'édition multi-références : vous lui fournissez jusqu'à 10 images, plus un prompt précisant le rôle de chacune.

Cet article présente six recettes d'édition que nous avons réellement exécutées sur l'API en ligne — composition multi-références, transfert de vêtement, recoloration précise, remplacement d'arrière-plan, transfert de style et étalonnage cinématographique en chaîne. Chaque prompt ci-dessous est la chaîne que nous avons envoyée telle quelle, et chaque image de sortie est un fichier réel renvoyé par l'API, sans aucune retouche. Trois des six ont réussi du premier coup, les trois autres ont rencontré un TASK_FAILED opaque et sont passés après une nouvelle soumission — plus de détails dans la section des pièges plus bas.

Structure de la requête (et son schéma strict)

seedream-5.0-pro/image-to-image s'exécute sur un point de terminaison de tâche asynchrone. Exactement quatre champs d'entrée, tous obligatoires :

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro/image-to-image",
    "input": {
      "prompt": "Recolor the ceramic pour-over mug to a matte black glaze with a thin brushed-gold rim along the lip. Preserve the identical mug shape, camera angle, soft studio lighting, contact shadow and warm off-white backdrop. Everything else in the frame stays untouched.",
      "image_urls": ["https://your-cdn.example.com/mug.jpg"],
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

La réponse renvoie un taskId ; interrogez GET /v1/tasks/{taskId} jusqu'à ce que status devienne success, puis téléchargez immédiatement output[0].url — les URL de sortie portent un expireAt et expirent.

Le schéma est strict, et le validateur vous dit clairement ce qui ne va pas. Les erreurs reçues pendant nos tests :

• Oubli d'un champ → missing required field "prompt"; ... "image_urls"; ... "aspect_ratio"; ... "resolution"
• Demande de 4K → resolution: value must be one of '1K', '2K'
• Ajout discret d'un champ supplémentaire comme n → additional properties 'n' not allowed
• Envoi de 11 images de référence → image_urls: maxItems: got 11, want 10

Donc : sortie en 1K ou 2K, 10 images de référence maximum, aucun champ supplémentaire. Les image_urls doivent être accessibles publiquement — la plateforme les récupère côté serveur. Le tarif est de 0,15 $ par image sur la page de tarifs, c'est pourquoi notre flux ci-dessous génère économiquement les images de référence avec gpt-image-2/text-to-image à 0,03 $, en réservant le budget Pro à l'édition elle-même.

Les quatre images de référence

Les quatre sont générées par gpt-image-2 (prompts omis par souci de concision — ce sont de simples descriptions de produit/portrait). Ce sont les entrées auxquelles chaque recette ci-dessous fait référence.

Recette 1 — composition multi-références : intégrer un produit dans une scène

Deux images de référence : le mug au premier plan, la cuisine en arrière-plan. Le prompt nomme le rôle de chaque image — c'est le cœur de la technique multi-références, car le modèle s'appuie sur l'ordre des image_urls pour interpréter « la première image » et « la seconde image ».

Place the terracotta pour-over coffee mug from the first image onto the empty oak
counter in the foreground of the second image. The mug sits naturally on the wood
surface, matching the warm golden sunrise lighting, with a soft window-light shadow
falling to the right. Keep the mug's shape, colour and matte ceramic material exactly
as in the reference. Keep the kitchen scene otherwise unchanged. Photorealistic
product photography.

aspect_ratio: "3:2" (adapté à la scène, pas au produit), resolution: "2K". Première génération :

Il ne s'est pas contenté de coller le mug — il a refait l'éclairage. La direction de l'ombre suit la fenêtre, le bord du mug capte la lumière du lever du soleil, et la céramique reste mate sans hériter de la lumière chaude de la scène.

Recette 2 — transfert de vêtement multi-références

Le portrait en premier, le vêtement ensuite. Ici, c'est la liste des éléments à préserver qui fait tout le travail : visage, cheveux, boucles d'oreilles, pose et arrière-plan sont tous verrouillés.

Dress the woman from the first image in the embroidered indigo denim jacket from the
second image, worn open over her grey sweatshirt. Keep her face, short black hair,
silver hoop earrings, expression, pose and the concrete wall background completely
unchanged. Match the overcast soft daylight and preserve the jacket's white floral
stitching details on the chest and sleeves.

aspect_ratio: "3:4", resolution: "2K" :

Le motif brodé est intact du plat jusqu'au porté — disposition sur les manches, la poitrine, et même la quincaillerie des boutons. C'est là que la gamme Pro justifie son prix : une seule génération préserve à la fois l'identité du sujet et les détails du vêtement.

Recette 3 — recoloration précise : le mode liste de préservation

Une seule image de référence. Le changement tient en une phrase ; tout le reste est une liste de ce qu'il faut préserver. C'est le modèle générique pour les tâches du type « modifie X, ne touche à rien d'autre ».

Recolor the ceramic pour-over mug to a matte black glaze with a thin brushed-gold rim
along the lip. Preserve the identical mug shape, camera angle, soft studio lighting,
contact shadow and warm off-white backdrop. Everything else in the frame stays
untouched.

aspect_ratio: "1:1", resolution: "2K" :

Même silhouette, même ombre, même arrière-plan — seule la couleur de l'émail a changé. Il a même ajouté un anneau doré en pied qui fait écho au bord, ce que nous n'avions pas demandé, mais que nous avons gardé.

Recette 4 — remplacement d'arrière-plan avec clause de rééclairage

Changer l'arrière-plan sans rééclairer le sujet donne une image composite qui ressemble à une silhouette en carton. La solution est de demander explicitement un rééclairage tout en verrouillant l'identité :

Swap the plain concrete wall behind the woman for a rain-soaked city street at night
glowing with neon signs, cyan and magenta reflections and soft distant bokeh. The
woman herself — face, short black hair, silver hoop earrings, expression, pose, grey
sweatshirt — stays exactly as she is, identity preserved. Add a subtle cool neon rim
light so she blends naturally into the night scene.

aspect_ratio: "3:4", resolution: "2K" :

Remarquez le reflet magenta sur sa droite et le liseré cyan sur le sweat — c'est la clause de rééclairage à l'œuvre. Même visage, mêmes boucles d'oreilles, univers totalement différent.

Recette 5 — transfert de style : photo en aquarelle

La stylisation est le type d'édition le plus permissif, donc le prompt concentre son budget sur ce qu'il faut préserver : la composition et l'ambiance.

Repaint this photograph as a loose watercolor illustration: visible paper grain, soft
pigment bleeds, delicate hand-drawn ink outlines. Keep the composition, the window,
the vase and the morning-light mood. Pastel palette dominated by warm yellows and
soft blues.

aspect_ratio: "3:2", resolution: "2K". Première génération :

Recette 6 — édition en chaîne : étalonnage cinématographique au-dessus de la recette 3

La sortie devient l'entrée. Nous reprenons le mug noir et or de la recette 3 — déjà téléversé sur notre propre CDN — directement comme image de référence pour la passe d'ambiance suivante :

Turn this product photo into a moody cinematic hero shot: dramatic low-key lighting,
background falling off into deep shadow, a gentle wisp of steam rising from the mug,
subtle film grain, teal-and-orange colour grade. Keep the mug's black-and-gold design,
shape and camera angle exactly identical.

aspect_ratio: "1:1", resolution: "2K". Première génération :

Ne modifier qu'une seule chose par étape vaut mieux qu'un seul énorme prompt : le résultat de la recoloration est verrouillé dès la première étape, et la passe d'étalonnage n'a plus qu'à gérer la lumière. L'édition en chaîne coûte 0,15 $ de plus, mais chaque étape peut être réessayée indépendamment — et réutilisée.

Les trois schémas de prompt qui font réellement le travail

1. Nommez le rôle de chaque image de référence. « Le mug de la première image », « le plan de travail de la seconde image » — l'ordre dans image_urls est celui auquel le prompt fait référence. L'ambiguïté ici est la première cause de modification erronée par le modèle.
2. Cible → modification → liste de préservation. Dites d'abord ce que vous éditez, puis énoncez la modification unique, puis énumérez tout ce qui ne doit pas bouger. La liste de préservation est la clé pour verrouiller l'identité, la lumière et la composition — sautez-la, et le modèle « optimisera » des choses que vous n'avez pas demandées.
3. Ajoutez une clause de rééclairage quand le sujet change d'univers. « Rééclaire-la légèrement avec une lumière de contour néon froide » fait toute la différence entre un composite et une photo.

Les pièges que nous avons réellement rencontrés

• Un TASK_FAILED sans détail est généralement passager. Trois de nos six recettes ont échoué ainsi à la première soumission — la même charge utile a réussi après réessai (une resoumission identique, deux légèrement reformulées). Ressoumettez d'abord, envisagez une réécriture ensuite.
• Le schéma ne plaisante pas. Pas de n, pas de seed, pas de size — exactement quatre champs, tout champ en plus = 400. Si vous migrez du code depuis un modèle plus permissif, pensez à épurer la charge utile.
• Seulement 1K/2K. Si vous avez besoin d'une sortie 4K pour cette série, c'est une fonctionnalité de la génération à partir de texte, pas de ce point de terminaison.
• Les URL des images de référence doivent être publiques. La plateforme les récupère côté serveur ; une URL présignée qui expire en cours de polling vous piégera.
• Téléchargez les sorties immédiatement. output[0].url expire. Récupérez les octets dans votre propre stockage avant toute autre chose.

Questions fréquentes

Quand Pro vaut-il 4 fois le prix de Lite ?seedream-5.0-lite/image-to-image coûte 0,035 $ et gère bien les éditions locales sur un seul sujet. Dans nos tests, Pro prend nettement l'avantage sur les tâches multi-références — préserver les détails du vêtement lors d'un transfert, maintenir l'identité lors d'un remplacement complet d'arrière-plan. Si l'édition implique deux images de référence ou plus, ou un visage qui ne doit en aucun cas dériver, utilisez Pro.

Comment se compare-t-il aux autres modèles d'édition ?Nous avons passé la même édition sur trois modèles dans la comparaison des API d'édition d'image — c'est un autre article, avec de vrais comparatifs côte à côte.

Puis-je générer les images de référence avec la même API ?Oui — chaque image de référence de cet article provient de gpt-image-2/text-to-image, à 0,03 $ l'unité, via le même point de terminaison /v1/tasks. Une seule clé, pour les deux étapes du flux de travail.

---

Dépense totale de toutes les éditions de cet article : six éditions Pro à 0,15 $ plus quatre images de référence à 0,03 $ — à peine plus d'un dollar. Prenez une clé, vérifiez le schéma à quatre champs dans la documentation, et commencez par recopier le mode liste de préservation de la recette 3 — c'est celui que vous utiliserez chaque jour. La référence complète des paramètres se trouve sur la page du modèle seedream-5.0-pro/image-to-image.