Guide de l'API Seedream 5.0 Lite : génération d'images et édition d'images

Résumé du contenu

• Seedream 5.0 Lite est le modèle d'image de ByteDance. Sur HiAPI, il dispose de deux endpoints : seedream-5.0-lite/text-to-image et seedream-5.0-lite/image-to-image, tous deux à 0,035 $ par image, au même prix en 2K ou 4K.
• Il excelle à rendre du texte de façon précise dans l'image, ainsi que dans l'édition ciblée : modifier un seul objet, remplacer le texte d'une enseigne, ou composer jusqu'à 14 images de référence tout en laissant le reste de la scène intact.
• Chaque appel doit fournir aspect_ratio et resolution. Ouvrez la page du modèle text-to-image pour l'essayer ; les nouveaux comptes reçoivent 200 crédits gratuits.

Text-to-image ou image-to-image

	Text-to-image	Image-to-image
ID du modèle	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Champs obligatoires	prompt, aspect_ratio, resolution	Idem, plus image_urls (1–14)
Prix	0,035 $ par image	0,035 $ par image, quel que soit le nombre d'images de référence
Cas d'usage	Affiches, menus, packaging, infographies	Changement de couleur, remplacement de texte, intégration de produit dans une scène

Tarifs HiAPI en temps réel, vérifiés le 19 octobre 2026. Les tâches échouées ne sont pas facturées.

Le 4K est au même prix que le 2K, donc demandez directement du 4K si vous avez besoin d'une taille pour l'impression. Avec 1 $, vous générez environ 28 images.

Text-to-image : un rendu de texte fidèle

Placez entre guillemets chaque mot que vous souhaitez voir rendu, et indiquez la position de chaque chaîne :

Une affiche de style sérigraphie dessinée à la main pour un festival gastronomique nocturne fictif, grand titre en calligraphie chinoise « 夜市食堂 » en haut, sous-titre anglais « NIGHT MARKET CANTEEN » juste en dessous dans une sans-serif condensée, ligne de date « OCT 17-19 · RIVERSIDE PIER » en bas, lueur chaude de lanternes au-dessus de stands de nourriture bondés, vapeur s'élevant de paniers en bambou, palette limitée de vermillon, crème et bleu encre, grain d'impression visible, composition d'affiche vintage

Générer cette affiche →

seedream-5.0-lite/text-to-image, 2K, 0,035 $.

Le titre chinois, le sous-titre anglais et la ligne de date apparaissent tels qu'ils ont été écrits. Le même schéma s'applique aux panneaux de menu, aux étiquettes de prix et au packaging ; limitez le texte à environ six lignes. Pour cinq autres modèles (dont un menu avec chaque prix correct), voir les recettes de prompts Seedream 5.0 Lite.

Image-to-image : ne changer qu'un détail, garder le reste

Schéma : une phrase décrit la modification, puis nommez tout ce qui doit rester inchangé.

Changement de couleur localisé. Image d'origine :

Transforme cette tasse en céramique blanche mate en une tasse émaillée bleu cobalt profond, avec un aspect brillant et réfléchissant, en gardant exactement identiques la vapeur, la table en chêne, le carnet ouvert, le stylo plume, la plante succulente, l'éclairage et l'angle de vue, rendu photoréaliste

seedream-5.0-lite/image-to-image, une image de référence, 3:2, 2K, 0,035 $.

Remplacement du texte d'une enseigne.

Remplace le texte de l'enseigne en bois au-dessus de la porte par « BAKERY CORNER », en conservant le même style de police dorée à empattements et la même taille de caractères, en gardant exactement identiques la forme et la texture boisée de l'enseigne, la façade en briques, les fenêtres éclairées, l'olivier et la lumière couverte, rendu photoréaliste

seedream-5.0-lite/image-to-image, une image de référence, 3:2, 2K, 0,035 $.

Composition de deux images. Référencez-les dans l'ordre où elles apparaissent dans image_urls :

Prends le sac à dos en cuir de la première image et place-le sur le gros rocher plat en granit de la scène de campement de la deuxième image, légèrement incliné et naturellement appuyé, en rééclairant pour correspondre à la chaude lumière dorée du soleil et en projetant une ombre douce sur le rocher, en gardant inchangés le cercle de feu en pierre, la forêt de pins et les sommets, composition photoréaliste

seedream-5.0-lite/image-to-image, deux images de référence, 3:2, 2K, 0,035 $.

Définissez aspect_ratio pour qu'il corresponde à l'entrée. Si vous demandez un format différent, une partie de l'édition sera perdue par un recadrage.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Vous recevez un taskId. Interrogez GET https://api.hiapi.ai/v1/tasks/{taskId} jusqu'à ce que data.status vaille success, puis téléchargez data.output[0].url. Les liens expirent, enregistrez le fichier immédiatement.

Pour une édition, remplacez le modèle par seedream-5.0-lite/image-to-image et ajoutez "image_urls": ["https://your-cdn.example.com/input.jpg"].

Python : générer, puis éditer

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

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

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Si vous devez réutiliser le résultat plus tard, téléchargez chaque résultat dès qu'il est prêt ; les liens de sortie expirent.

Paramètres

Champ	Obligatoire	Valeurs	Description
prompt	Oui	4–3 000 caractères	Placez entre guillemets le texte à rendre
aspect_ratio	Oui	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	En édition, conservez le même que l'entrée
resolution	Oui	2K, 4K	En majuscules ; même prix
image_urls	Image-to-image uniquement	1–14 URL	jpeg, png ou webp, 10 Mo maximum chacune

Il n'y a pas de seed, negative_prompt ni output_format.

Erreurs courantes

Les erreurs suivantes renvoient toutes un HTTP 400 à la soumission : aucune tâche n'est créée et aucun frais n'est facturé :

• aspect_ratio: missing required field / resolution: missing required field : les deux sont obligatoires, même si la documentation indique des valeurs par défaut.
• resolution: value must be one of '2K', '4K' : il n'y a pas de 1K. Utilisez des majuscules.
• image_urls: maxItems: got 15, want 14 : 14 images de référence au maximum.
• prompt: minLength: got 2, want 4 : le prompt doit contenir au moins 4 caractères.
• additional properties 'output_format' not allowed : ce champ n'existe pas sur Lite.

Lite, Flash ou Pro ?

Modèle	Prix par image	Cas d'usage
Seedream 5.0 Flash	0,025 $	Quand le volume et la vitesse priment
Seedream 5.0 Lite	0,035 $ en 2K comme en 4K	Texte dans l'image, édition fine, 4K sans surcoût
Seedream 5.0 Pro	0,05 $ (1K) / 0,10 $ (2K)	Quand l'asset final exige le plus haut niveau de détail

Pour un test comparatif des deux paliers les moins chers avec le même prompt, voir Seedream 5.0 Flash vs Lite. Pour la tarification complète, voir la tarification de l'API Seedream 5.0.

Questions fréquentes

Chaque image de référence est-elle facturée en supplément ?

Non. L'image-to-image coûte 0,035 $ par sortie, que vous envoyiez 1 ou 14 images de référence.

Peut-il rendre du texte chinois ?

Oui. L'affiche ci-dessus contient à la fois un titre chinois et un sous-titre anglais dans la même image. Il suffit de mettre chaque chaîne entre guillemets et d'ancrer sa position.

Mon produit restera-t-il parfaitement identique ?

Il conserve ce que vous nommez. Listez tous les éléments qui doivent rester inchangés (forme, étiquette, éclairage, angle de vue) ; tout ce qui n'est pas mentionné peut changer.

Choisir 2K ou 4K ?

Le prix est identique. En 2K, le grand côté fait environ 2 300 px, en 4K environ 4 096 px. Les fichiers 2K sont plus légers et plus faciles à consulter pendant les itérations ; passez en 4K si vous avez besoin d'imprimer.