Recettes de prompts image-à-image pour Seedream 5.0 Lite : 3 cas d'édition prêts à copier-coller, avec résultats avant/après réels

Générer une image à partir de zéro est un problème résolu. Le travail plus difficile, celui qui apparaît réellement dans les chaînes de production, c'est l'édition : ne changer que ce point précis, et tout conserver par ailleurs. seedream-5.0-lite/image-to-image est conçu exactement pour cela : édition basée sur des instructions, jusqu'à 14 images de référence, zones non éditées laissées intactes.

Cet article propose trois recettes d'édition prêtes à copier-coller, correspondant à trois tâches d'édition véritablement importantes : une retouche locale précise, une composition multi-références, un remplacement de texte. Chaque image « après » ci-dessous est le résultat de la première génération avec le prompt indiqué — chaque édition n'est exécutée qu'une seule fois, sans relance, sans sélection. Les images « avant » sont générées avec le modèle frère texte-à-image, ce qui vous permet de reproduire l'intégralité de cet article de bout en bout pour environ un quart du prix.

Si vous voulez découvrir les capacités t2i du modèle — affiches, menus, rendu de texte — nous les avons déjà couvertes dans six recettes de prompts t2i. Ici, tout porte sur l'édition.

Configuration en 30 secondes

Le point de terminaison d'édition fonctionne sur l'API de tâches asynchrones de hiapi : créez une tâche avec l'URL de votre image de référence, interrogez la tâche, téléchargez le résultat.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "YOUR EDIT INSTRUCTION",
      "image_urls": ["https://your-host.com/input.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'
# → {"data": {"taskId": "..."}}

curl https://api.hiapi.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# poll until "status": "success", then download output[0].url

Quatre choses à savoir avant votre première édition :

• image_urls, aspect_ratio et resolution sont tous obligatoires. Si l'un manque, l'API renvoie 400 et signale le champ manquant (image_urls: missing required field "image_urls"; …). Les URL doivent être accessibles publiquement.
• resolution n'accepte que "2K" ou "4K". Passer "1K" renvoie 400: resolution: value must be one of '2K', '4K' — même règle que le point de terminaison t2i. Toutes les images de cet article sont en 2K.
• Faites correspondre aspect_ratio à l'image d'entrée. Toutes nos images de référence sont en 3:2, donc chaque édition demande une sortie en 3:2. Lutter contre la géométrie de l'image d'entrée ne fait que gaspiller votre édition en recadrages.
• Les URL de sortie expirent. Téléchargez le fichier dès que la tâche réussit ; ne le liez pas à chaud.

Quel que soit le nombre d'images de référence envoyées, le prix est fixe : 0,035 $ par image — voir la grille tarifaire. Prévoyez une à deux minutes d'interrogation par édition en 2K ; n'espérez pas de retour synchrone.

Recette 1 : retouche locale précise

Tâche : changer le matériau et la couleur d'un objet, sans toucher au reste de la scène. C'est l'édition la plus courante pour les variantes de produits — et l'endroit où la plupart des modèles d'édition redessinent discrètement toute votre scène.

Image d'entrée, générée par t2i :

Instruction d'édition :

Change the matte white ceramic mug into a deep cobalt blue glazed mug
with a glossy reflective finish, keep the steam, the oak desk, the open
notebook, the fountain pen, the succulent, the lighting and the camera
angle exactly unchanged, photorealistic

Première génération :

La tasse passe du blanc mat à un émail cobalt brillant — y compris les nouveaux reflets spéculaires — tandis que le carnet, la pointe du stylo, la plante succulente et la lumière de la fenêtre restent en place. Remarquez la structure en trois parties du prompt : nommer la cible (« the matte white ceramic mug »), décrire la modification (« deep cobalt blue glazed, glossy »), puis énumérer une par une les éléments qui ne doivent pas bouger. Cette liste de préservation n'est pas décorative ; c'est elle qui verrouille le reste de l'image. Les détails retravaillés par le modèle (les volutes de vapeur, par exemple) diffèrent au niveau pixel même lorsque la mise en page reste identique — prévoyez donc la tolérance en conséquence.

Recette 2 : composition multi-références

Tâche : prendre un sujet dans une image et le placer dans la scène d'une autre. seedream-5.0-lite accepte jusqu'à 14 images de référence dans un seul appel ; ici, nous en utilisons deux.

Image de référence 1 — le sujet, photo produit en studio :

Image de référence 2 — la scène :

Instruction d'édition — notez les ordinaux, c'est ainsi que vous référencez chaque image :

Take the leather backpack from the first image and place it on the flat
granite boulder in the campsite scene from the second image, leaning
naturally at a slight angle, relit to match the warm golden-hour sunlight
with a soft shadow falling across the rock, keep the stone fire ring,
pine forest and mountain peaks unchanged, photorealistic composite

Première génération :

Le sac à dos conserve les boucles, les coutures et les détails des sangles de la photo studio, mais l'éclairage passe de la lumière diffuse du studio à un soleil chaud et directionnel, projetant une ombre de contact sur le granit. Le cercle de feu, la ligne des arbres et les sommets restent intacts. Pour toute composition multi-références, attendez-vous à deux choses : le modèle ajuste légèrement la pose du sujet pour l'intégrer naturellement à la scène (notre sac à dos est un peu plus incliné que sur la photo studio), et il recalcule l'éclairage globalement plutôt que de coller des pixels. Si vous avez besoin d'un sujet identique au pixel près, ce n'est pas le bon outil — ce que vous obtenez, c'est une composition sans traces de collage.

Recette 3 : remplacement de texte

Tâche : changer le texte sur une enseigne sans reconstruire toute la façade. La force de Seedream, c'est le rendu de texte, et cette capacité s'étend au point de terminaison d'édition.

Image d'entrée :

Instruction d'édition :

Replace the text on the wooden sign above the door so it reads
'BAKERY CORNER' in the same gold serif lettering style and size, keep
the sign shape and wood texture, the brick facade, the glowing window,
the olive trees and the overcast lighting exactly unchanged,
photorealistic

Première génération :

« BAKERY CORNER » est revenu dès la première tentative, correctement orthographié, correctement crénelé, dans la même police dorée à empattements que l'original. Les couches de briques, les oliviers et la lumière chaude de la fenêtre sont restés inchangés. Citez la chaîne exacte souhaitée ('BAKERY CORNER'), ancrez-la à un emplacement (« on the wooden sign above the door ») et exigez le style d'origine (« same gold serif lettering style and size ») — la même discipline de citation qui a donné 16/16 chaînes correctes dans nos tests t2i s'applique tout autant à l'édition.

Le schéma des prompts d'édition

Les trois recettes sont la même phrase, seuls les noms changent :

1. Cible — nommez l'objet à éditer avec un attribut identifiant : « the matte white ceramic mug », « the text on the wooden sign above the door ».
2. Modification — précisez le nouvel état : matériau, couleur, finition de surface, texte exact cité, position dans la scène.
3. Liste de préservation — énumérez un par un ce qui doit être conservé : objets, éclairage, angle de caméra. Terminez par « exactly unchanged ». La liste de préservation est l'élément à plus fort levier du prompt ; chaque nom que vous y inscrivez est une chose que le modèle n'improvisera pas.
4. Ordinaux pour les références multiples — avec plusieurs image_urls, référencez-les par « the first image », « the second image ». L'ordre du tableau est l'ordre du prompt.
5. Faites correspondre la géométrie — demandez le même rapport hauteur/largeur que l'entrée, et rappelez-vous que resolution n'accepte que 2K ou 4K.

Une mise en garde honnête : l'édition est un nouveau rendu, pas un masque Photoshop. Les zones touchées par le modèle (vapeur, reflets, bords du feuillage) présentent de légères différences entre l'avant et l'après. Ces recettes vous apportent la stabilité de la mise en page, de l'identité et du style — pas une égalité bit à bit des zones non éditées.

Reproduire ces éditions en Python

import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

task = requests.post(API, headers=HEADERS, json={
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
        "prompt": "Change the matte white ceramic mug into a deep cobalt "
                  "blue glazed mug with a glossy reflective finish, keep "
                  "the steam, the oak desk, the open notebook, the fountain "
                  "pen, the succulent, the lighting and the camera angle "
                  "exactly unchanged, photorealistic",
        "image_urls": ["https://your-host.com/desk-mug.jpg"],
        "aspect_ratio": "3:2",
        "resolution": "2K",
    },
}).json()
task_id = task["data"]["taskId"]

while True:
    t = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
    if t["status"] in ("success", "fail"):
        break
    time.sleep(5)

if t["status"] == "success":
    url = t["output"][0]["url"]  # expires — download immediately
    open("edited.jpg", "wb").write(requests.get(url).content)

Pour les recettes 2 et 3, il suffit de remplacer prompt et image_urls. Pour approfondir le cycle de vie des tâches — gestion des erreurs, délais d'expiration, webhooks — voir le tutoriel sur l'API image-à-image.

FAQ

Combien d'images de référence puis-je envoyer ? Jusqu'à 14 dans un seul tableau image_urls, toutes facturées comme une seule édition à 0,035 $. En pratique, deux ou trois références bien choisies surpassent dix références floues — chaque image supplémentaire dilue l'attention accordée à chacune.

Peut-il conserver la cohérence des visages/produits d'une édition à l'autre ? Pour les objets, l'identité est bien préservée (notre sac à dos a gardé sa quincaillerie et ses coutures malgré un rééclairage complet). Pour les travaux produits où le pixel est critique — motifs d'étiquettes précis, mentions réglementaires —, vérifiez chaque sortie ; le modèle effectue un nouveau rendu et non un masquage. Pour un exemple de production, voir comment nous générons des images produits e-commerce avec ce point de terminaison.

Pourquoi mon appel renvoie-t-il 400 ? Trois causes courantes : un champ obligatoire manquant (image_urls, aspect_ratio et resolution sont tous imposés), une resolution définie à une valeur autre que 2K/4K, ou une URL d'image de référence non accessible publiquement.

2K ou 4K ? Utilisez 2K pour itérer — toutes les images de cet article sont en 2K, et le texte de la recette 3 reste net. Réservez le 4K aux assets finaux d'impression/visuels principaux ; le prix par image est le même, mais la génération est plus longue.

---

Trois éditions, trois premières générations, 0,035 $ chacune. Le schéma — cible, modification, liste de préservation — semble délibérément ennuyeux : les prompts ennuyeux sont les prompts reproductibles. Prenez une clé API, pointez la page du modèle seedream-5.0-lite/image-to-image vers vos propres images « avant », et commencez par la recette 1 — le remplacement d'un seul objet est le moyen le plus rapide de comprendre à quel point la liste de préservation peut verrouiller le contenu.