Comment utiliser l’API Seedgream 4.5

CometAPI
AnnaDec 9, 2025
Comment utiliser l’API Seedgream 4.5

Seedream 4.5 est la toute dernière évolution de la famille Seedream de modèles de génération texte‑vers‑image / d’édition d’images (développée par la recherche Byte/BytePlus). Elle est en cours de déploiement sur les endpoints officiels de BytePlus et sur plusieurs plateformes tierces — y compris un accès intégré via des passerelles multi‑modèles telles que CometAPI — et apporte une meilleure cohérence du sujet, une typographie/un rendu de texte améliorés, et une fidélité accrue pour l’édition multi‑images.

Cet article est un guide pratique et professionnel pour utiliser l’API Seedream 4.5. Vous y trouverez des étapes d’installation concrètes, l’authentification et les schémas de requêtes, les bonnes pratiques de prompts et de paramètres, les workflows d’édition et multi‑images, la gestion des erreurs, les modèles de déploiement, ainsi que les considérations juridiques/de sécurité.

Qu’est-ce que Seedream 4.5 ?

Seedream 4.5 est la dernière itération de la famille Seedream — un modèle multimodal de génération et d’édition d’images conçu pour une création texte‑vers‑image haute fidélité et une édition d’images contextuelle (image‑vers‑image, édition multi‑références, inpainting/outpainting, gestion de la typographie et des textes denses). Par rapport aux versions antérieures de Seedream, la 4.5 met l’accent sur une meilleure cohérence du sujet dans les workflows multi‑images, une préservation plus stricte des détails de référence, une fidélité typographique plus élevée (texte dans les images) et une meilleure qualité de sortie jusqu’à 4K/ultra‑HD en paramètres « high quality ». Ces améliorations proviennent d’une architecture mise à l’échelle et d’un réglage de prompts/heuristiques côté moteur mis à jour.

Pourquoi c’est important : 4.5 est délibérément conçue pour traiter des tâches créatives professionnelles — variantes de produits en batch, éditions multi‑images conformes à la marque et assets d’impression haute résolution — tout en permettant un contrôle plus fin avec des images de référence et des opérations d’édition spécialisées.

Capacités principales

  • Génération texte‑vers‑image (unitaire et batch) : générez 1 à 15 images par appel d’API, avec des modes de qualité sélectionnables (Basic vs High) qui arbitrent entre vitesse et résolution.
  • Édition d’images (i2i / inpainting / outpainting) : utilisez une ou plusieurs images de référence ; préserve les détails et les relations spatiales sur plusieurs références.
  • Fusion multi‑références et copie d’éléments : jusqu’à ~10 images de référence peuvent être utilisées dans un même job pour transplanter des éléments tout en conservant une cohérence d’éclairage/de perspective.
  • Rendu de typographie/texte dense de haut niveau : meilleure gestion des images contenant du texte ou de la signalétique (utile pour les maquettes, étiquettes produit, captures d’interface).
  • Streaming / sortie progressive : certains endpoints de déploiement prennent en charge le streaming pour que les clients puissent recevoir des résultats partiels pendant que la génération se poursuit.

Comment utiliser l’API Seedream 4.5 via CometAPI ?

Ci‑dessous, un guide pratique prêt à copier‑coller pour générer des images via CometAPI (un agrégateur qui expose le modèle Seedream 4.5 en tant que paramètre de modèle). Utilisez CometAPI lorsque vous souhaitez une seule clé API pour accéder à des dizaines/centaines de modèles et une surface REST stable et facile à intégrer. La documentation CometAPI présente l’alias de modèle doubao-seedream-4-5-251128 et un endpoint standard de génération d’images.

Étapes générales

  1. Inscrivez‑vous à CometAPI et obtenez une clé API.
  2. Utilisez l’endpoint de génération d’images (POST https://api.cometapi.com/v1/images/generations) avec le paramètre model défini sur l’identifiant Seedream 4.5 (exemple : doubao-seedream-4-5-251128).
  3. Incluez le prompt, des images de référence facultatives (URL ou chargements multipart selon l’agrégateur), la taille/la qualité de sortie et d’autres paramètres.
  4. Recevez une réponse JSON contenant les URL d’images générées (ou du base64) et des métadonnées.

Types de requêtes et modes

Seedream 4.5 prend généralement en charge :

  • Texte → Image (prompts textuels → images nouvelles)
  • Image → Image (images de référence + prompts pour des transformations stylisées)
  • Édition d’images / Inpainting (masque + instructions d’édition pour des modifications ciblées)
    Les API hébergées prennent en charge des modes de tâches asynchrones (soumettre un job → sonder avec taskId), adaptés aux rendus longs et aux workflows batch. Les liens générés sont souvent limités dans le temps (p. ex., valides 24 heures sur certaines passerelles) : prévoyez stockage/export.

curl example (text-to-image, single prompt)

curl -X POST "https://api.cometapi.com/v1/images/generations" \
  -H "Authorization: Bearer COMETAPI_KEY_GOES_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic portrait of a cyberpunk fox in neon rain, 4k, detailed lighting, film grain",
    "n": 3,
    "width": 2048,
    "height": 2048,
    "quality": "high",     # or "basic"
    "seed": 12345,
    "style": "photorealistic"
  }'

Remarques

  • Remplacez COMETAPI_KEY_GOES_HERE par votre clé CometAPI.
  • Le paramètre n génère plusieurs variantes en un seul appel (réduit la surcharge).
  • quality: "high" correspond généralement à une résolution plus élevée / un coût de calcul supérieur (souvent compatible 4K).

Exemple Python requests (texte‑vers‑image + sauvegarde des résultats)

import requests, base64, os

API_URL = "https://api.cometapi.com/v1/images/generations"
API_KEY = os.environ.get("COMETAPI_KEY")  # set env var for safety

payload = {
  "model": "doubao-seedream-4-5-251128",
  "prompt": "Studio shot of a ceramic mug on a wooden table, warm natural light, ultra-detailed, 2k",
  "n": 2,
  "width": 1024,
  "height": 1024,
  "quality": "basic"
}

resp = requests.post(API_URL, json=payload, headers={
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
})
resp.raise_for_status()
data = resp.json()

# Example: each item has 'b64_json' or 'url' depending on provider
for i, item in enumerate(data.get("data", [])):
    img_b64 = item.get("b64_json")
    if img_b64:
        img_bytes = base64.b64decode(img_b64)
        with open(f"seedream_result_{i}.png", "wb") as f:
            f.write(img_bytes)
    else:
        print("Image URL:", item.get("url"))

Pourquoi ce schéma ? Les agrégateurs renvoient couramment soit une charge utile base64, soit des URL hébergées ; le code gère les deux. L’endpoint renverra généralement un task_id. Sondez l’endpoint GET /tasks/{task_id} jusqu’à ce que le statut soit succeeded et téléchargez ensuite le résultat. De nombreux fournisseurs incluent des SDK avec des assistants intégrés pour ce schéma.

Comment optimiser la qualité de l’image et garder le texte lisible ?

  1. Utilisez des images de référence pour un contexte et un appariement des couleurs cohérents.
  2. Mentionnez explicitement la typographie dans le prompt (famille de police, graisse, alignement) et envisagez d’ajouter le texte exact en surimpression dans une deuxième étape pour garantir la lisibilité.
  3. Mettez en place un processus en deux étapes : (a) générer la composition de base ; (b) ré‑rendre ou éditer dans un second passage ciblé sur les gros plans ou les zones d’étiquettes avec une résolution plus élevée.

Comment rédiger des prompts pour Seedream 4.5 ?

Principes d’ingénierie des prompts

  • Soyez explicite : listez le sujet, l’action, le style, l’objectif/appareil, l’heure de la journée et la palette de couleurs souhaitée.
  • Utilisez des ancres d’identité : si vous avez besoin du même visage/objet sur plusieurs images, incluez des descripteurs persistants (par ex. « la même femme aux cheveux courts et ondulés, veste verte, cicatrice sur le sourcil gauche ») et fournissez 1 à 3 images de référence. La fusion multi‑références de Seedream 4.5 s’améliore, mais les ancres aident.
  • Prompts négatifs : indiquez explicitement ce qu’il faut éviter (par ex. « pas de texte », « pas de filigranes », « pas de membres supplémentaires »).
  • Hybride court + long : donnez une instruction canonique courte, puis complétez avec quelques lignes de détails et de contraintes.

Modèles de prompts d’exemple

Photo produit héro (photoréaliste) : "Un visuel héro propre d’une enceinte sans fil noire mate posée sur une table blanche, éclairage softbox, 50mm, faible profondeur de champ, fond studio, photoréaliste, sans texte"

Illustration fantastique (stylisée) : "Paysage de fantasy épique, château de verre gigantesque sur une falaise, heure dorée, brouillard volumétrique, style peint, très détaillé, concept art"

Édition d’image (supprimer un objet) : "Supprimer la personne à gauche et étendre l’arrière‑plan pour combler l’espace, garder un éclairage cohérent, pas d’artefacts"

Maquette à forte typographie : "Maquette d’écran d’accueil d’application mobile sur un iPhone 14, avec le texte 'Launch Now' en Gotham Bold, rendre le bouton vert et garder des ombres douces"

Portrait de personnage : "Portrait héroïque d’une guerrière, éclairage de contour cinématographique, objectif portrait 85mm, texture de peau ultra détaillée, taches de rousseur naturelles, armure en cuir, arrière‑plan neutre, photoréaliste."

Prompts multi‑images et de référence

Lors de l’édition multi‑images, indiquez quelle image de référence correspond à quelle partie du prompt. Seedream 4.5 s’améliore dans l’identification du sujet principal à partir de multiples références — mais être explicite (par ex. « utiliser image_1 pour le visage, image_2 pour la texture des vêtements ») donne de meilleurs résultats.

Sélection des sorties et post‑traitement

  • Générez N variantes et appliquez des filtres objectifs : score de similarité de visage, comparaison d’histogrammes de couleur, OCR de typographie pour vérifier l’exactitude du texte.
  • Automatisez des seuils de contrôle qualité pour router les sorties en dessous du seuil vers une retouche manuelle.
  • Déléguez la typographie finale à des outils de mise en page si vous avez besoin d’un texte au pixel près — utilisez le modèle pour les arrière‑plans et les images, puis composez le texte précis en post‑production. Cela réduit la nécessité de s’appuyer sur la fidélité textuelle du modèle pour les assets marketing.

Comment effectuer l’édition d’images, l’inpainting et la composition multi‑images ?

Flux de travail d’édition d’images

  1. Téléchargez la/les image(s) de référence auprès du fournisseur ou envoyez‑les en ligne dans la requête.
  2. Fournissez un masque (image binaire) pour l’inpainting ou une annotation de délimitation pour des éditions ciblées.
  3. Envoyez un prompt d’édition précisant quelles régions modifier et lesquelles préserver.

De nombreuses API prennent en charge à la fois les modes d’édition d’une seule image et de composition multi‑images ; la 4.5 est explicitement réglée pour préserver l’identité du sujet et améliorer la cohérence multi‑images.

Exemple : charge utile d’inpainting (pseudocode JSON)

{
  "model": "seedream-4.5",
  "mode": "image_edit",
  "image_url": "https://.../original.png",
  "mask_url": "https://.../mask.png",
  "prompt": "Replace background with a sunset beach — keep subject untouched, maintain original lighting on subject",
  "guidance": 9,
  "steps": 40
}

Conseils pour une édition multi‑images cohérente

  • Utilisez la même seed pour des rendus liés afin de maintenir la cohérence entre les images.
  • Conservez des descripteurs caméra cohérents dans les prompts (par ex. « 85mm portrait, softbox, 3/4 ») pour maintenir la cohérence du point de vue.
  • Lors de l’édition de visages, demandez des clauses de préservation fines (« préserver la structure du visage, ne changer que la couleur des cheveux ») pour réduire la dérive d’identité.

Quelles sont les meilleures pratiques lors de l’utilisation de Seedream 4.5

Comment dépanner les problèmes courants ?

Voici des étapes pratiques de dépannage lorsque les résultats ne sont pas satisfaisants :

Visages flous / détails erronés

Augmentez la spécificité du prompt pour les détails du visage (âge, expression, éclairage), fournissez des images de référence de meilleure qualité, ou essayez une instruction explicite « préserver le visage » et abaissez la strength d’édition pour conserver davantage l’original. Seedream 4.5 améliore le réalisme des visages, mais la qualité des entrées reste déterminante.

Le texte est illisible ou brouillé

Fournissez du texte vectoriel ou matriciel en surcouche si vous avez besoin d’une typographie au pixel près ; sinon, utilisez des paramètres de résolution plus élevés et des instructions de style explicites « rendre le texte lisible : oui ». La 4.5 améliore la gestion des textes denses par rapport aux versions précédentes, mais la perfection typographique peut toujours nécessiter une composition en post‑production.

Éclairage ou composition incohérents dans un batch

Utilisez un prompt modélisé avec des mentions d’éclairage/caméra fixes, ou générez au sein d’un seul appel batch pour accroître la cohérence. BytePlus et CometAPI proposent des schémas d’inférence batch pour cette raison.

Notes finales et prochaines étapes

Seedream 4.5 est un modèle d’image mûr, orienté production, avec des améliorations explicites destinées aux workflows créatifs réels : meilleure cohérence, texte et rendu des visages améliorés, et prise en charge multi‑références — utilisez CometAPI ou des agrégateurs similaires lorsque vous souhaitez une expérimentation rapide et une flexibilité multi‑modèles.

Les développeurs peuvent accéder à l’API Seedream 4.5 via CometAPI, la dernière version du modèle est toujours mise à jour avec le site officiel. Pour commencer, explorez les capacités du modèle dans le Playground et consultez le guide de l’API pour des instructions détaillées. Avant d’y accéder, assurez‑vous d’être connecté à CometAPI et d’avoir obtenu la clé API. CometAPI propose un tarif bien inférieur au prix officiel pour vous aider à intégrer.

Prêt à démarrer ?→ Essai gratuit de Seedream 4.5 !

Si vous souhaitez plus d’astuces, de guides et d’actualités sur l’IA, suivez‑nous sur VK, X et Discord !

En savoir plus

500+ Modèles en Une API

Jusqu'à 20% de réduction