Seedream-5.0-Pro
Génération d'images Seedream-5.0-Pro
- Mode de traitement asynchrone, retourne un identifiant de tâche pour les requêtes ultérieures
- Prend en charge texte-vers-image, image-vers-image simple et multi-références (jusqu’à 10 images de référence)
- Prend en charge les niveaux de résolution 1K / 1.5K / 2K, ou des pixels exacts via
size - Modèle image unique : une image par requête ; sortie PNG / JPEG
- Les liens des images générées sont valides 72 heures, veuillez les enregistrer rapidement
POST
Autorisations
string
requis
Tous les points de terminaison de l’API nécessitent une authentification Bearer TokenObtenez votre clé API :Visitez la page de gestion des clés API pour obtenir votre clé APIAjoutez-la à l’en-tête de la requête :
Modèle à image unique :
seedream-5-0-pro ne génère qu’une image par requête (sauf lors de la décomposition en calques). Les paramètres suivants sont refusés (HTTP 400, aucune tâche, aucun frais) :n > 1sequential_image_generation(la génération groupée n’est pas prise en charge)stream(le streaming n’est pas pris en charge)tools(la recherche web n’est pas prise en charge)- plus de 10 éléments dans
image_urls
Édition interactive
Utilisez des coordonnées
<point> / <bbox> dans le prompt, ou chargez une image annotée à la main, afin de cibler précisément les modifications.- Coordonnées d’un point :
<point>x y</point>(indiquent un point unique ; le modèle détermine la zone affectée) - Coordonnées d’un cadre :
<bbox>x1 y1 x2 y2</bbox>(indiquent les coordonnées du coin supérieur gauche et du coin inférieur droit afin de contrôler précisément la taille de la zone d’édition)
Décomposition en calques
Décomposez une image en une image de base et jusqu’à 16 calques PNG transparents, avec leurs informations de position et d’empilement.
Body
string
défaut:"seedream-5-0-pro"
requis
Nom du modèle de génération d’images
seedream-5-0-pro(recommandé)- Également accepté :
seedream-5.0-pro
boolean
défaut:"false"
Indique s’il faut modérer le contenu avant d’envoyer la tâche d’image.
true: vérifier les prompts et les images d’entrée avecomni-moderation-latestfalseou omis : ne pas envoyer de requête de modération, sans coût ni latence de modération supplémentaires (par défaut)
string
requis
Description textuelle pour la génération d’imagesFacultatif lorsque
layer_decomposition: true ; s’il est omis, le modèle identifie et sépare automatiquement les principaux éléments de l’image.Outre le chinois et l’anglais, la génération native de texte prend en charge le russe, l’arabe, le filipino, le thaï, le turc, le coréen, le malais, l’espagnol, le portugais, l’indonésien, le français, l’allemand, le vietnamien et le japonais.Conseil : restez sous 600 mots anglais ; une description trop longue peut entraîner une perte de détails.
string
défaut:"1K"
Palier de résolution (minuscules acceptées). Il s’agit d’une extension API Mart équivalente à l’indication directe du palier dans
size.1K(par défaut)1.5K(même prix que 1K, meilleure qualité — préférez 1.5K sauf raison contraire)2K
size sous forme de palier et resolution sont tous deux fournis, size est prioritaire.string
défaut:"auto"
Un mot-clé de palier, un format d’image, Ces deux syntaxes sont équivalentes. Si seul un palier est indiqué, décrivez la mise en page souhaitée dans le prompt (par exemple, “affiche en portrait” ou “couverture en paysage”) et laissez le modèle choisir le format d’image.
auto ou des dimensions exactes en pixels.Syntaxe ① : palier de résolution (recommandé)
Le palier peut être indiqué directement danssize ou via le champ d’extension API Mart resolution :Syntaxe ② : palier + format d’image
Utilisé avecresolution. Rapports pris en charge :1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9- Accepte aussi le séparateur
xstyle16x9 2x1équivaut à2:1et1x2à1:2. Lexdoit être en minuscule et les espaces ne sont pas acceptés.auto(par défaut) : seul le niveau de résolution s’applique ; le rapport final est choisi d’après le prompt / les références
9:21) renvoient 400 — pas de repli silencieux vers 1:1.Niveau × rapport → pixels de sortie :Syntaxe ③ : pixels exacts
Lorsquesize est widthxheight, les pixels sont utilisés tels quels et resolution ne s’applique pas. Accepte 2048X1024 / 2048×1024.string
défaut:"opaque"
Mode d’arrière-plan de sortie :
opaque: arrière-plan opaque (par défaut)transparent: arrière-plan transparent
transparent n’est disponible que pour les requêtes image-vers-image comportant exactement une image d’entrée qui possède déjà un canal alpha ; output_format: "png" est également requis.boolean
défaut:"false"
Indique s’il faut décomposer l’image en calques. Lorsque cette option est activée, le modèle renvoie une image de base et jusqu’à 16 calques PNG avec canal alpha.Une seule image PNG ou JPEG est requise. Elle doit contenir entre
[262144, 36000000] pixels au total et ne pas dépasser 30 Mo. size n’accepte que 1K, 1.5K, 2K ou auto, avec auto par défaut. output_format ne contrôle que le format de l’image de base ; les calques décomposés sont toujours au format PNG.object
défaut:"{\"mode\":\"standard\"}"
Mode d’optimisation du prompt :
standard: mode standard offrant une meilleure qualité (par défaut)
"optimize_prompt_options.mode": "standard" est également acceptée.integer
défaut:"1"
Nombre d’images à générer. Seule la valeur
1 est prise en charge ; utilisez seedream-5-0-lite pour la génération groupée d’images.array
Liste d’URL d’images de référence pour image-to-image simple / multi-références, jusqu’à 10Deux formats :1. URL publique
http://ouhttps://- Exemple :
https://example.com/image.jpg
- Format :
data:image/<format>;base64,<data>—<format>doit être en minuscules - Exemple :
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
- Formats : jpeg / png / webp / bmp / tiff / gif / heic / heif
- Rapport d’aspect (l/h) :
[1/16, 16] - Chaque côté > 14 px
- Taille ≤ 30 Mo
- Pixels totaux ≤
6000×6000(36 000 000)
Facturation : première image de référence gratuite ; chaque image supplémentaire a un supplément fixe.
string
défaut:"jpeg"
Format de l’image de sortie
jpeg(par défaut)png
Compatibilité :response_formatest équivalent àoutput_format; les autres valeurs sont traitées commejpeg.
boolean
défaut:"false"
Ajouter ou non un filigrane « AI generated » en bas à droite
true: ajouter le filigranefalse: pas de filigrane (par défaut)
Exemples de requêtes
Texte-vers-image (niveau + rapport)
Texte-vers-image (pixels exacts)
Multi-références
Recommandé : 1.5K même prix, meilleure qualité
Décomposition en calques
<bbox> normalisées sur 0–1000 afin d’identifier précisément les éléments à extraire :
Édition interactive
Décrivez en langage naturel les annotations dessinées à la main dans l’image :<point> / <bbox> :
Édition du canal alpha
Exemple complet : envoyer une tâche et récupérer l’image
Le script suivant illustre le flux complet : envoyer une tâche asynchrone, interroger son état, gérer les échecs et lire l’URL finale de l’image. RemplacezYOUR_API_KEY avant de l’exécuter.
Python
Les images renvoyées sont répliquées dans un stockage géré par la plateforme. Téléchargez-les et conservez-les néanmoins rapidement dans votre propre système ; ne considérez pas l’URL du résultat comme un stockage permanent.
Scénarios cURL complets
Composition multi-image (jusqu’à 10 références)
Pixels exacts, optimisation du prompt et filigrane
Décomposer et modifier séparément un calque transparent
Commencez par décomposer l’image source :Réponse de décomposition en calques et reconstruction
Les tableauxurl, sizes, output_formats et layers se correspondent par indice ; l’indice 0 représente toujours l’image de base :
z_index. Pour les reconstruire sur l’image de base de sortie avec des coordonnées absolues :
W × H, utilisez les coordonnées normalisées :
Notes de facturation
- 1.5K au même prix que 1K ($0.045).
- Avec des pixels exacts dans
size, la facturation suit la surface de sortie réelle ;resolutionn’intervient pas (ex.size: "2048x2048"→ $0.09). - La 1ʳᵉ image de référence est gratuite ; chaque image suivante a une majoration.
- Les tâches en échec sont intégralement remboursées.
Préautorisation et facturation de la décomposition en calques
Le nombre et les dimensions finales des calques étant inconnus à l’envoi de la tâche, la préautorisation applique des règles prudentes fondées sur la requête :- Pixels exacts : palier déterminé par la surface demandée en pixels.
1K/1.5K: préautorisation au palier 1K.2K: préautorisation au palier 2K.auto: pouvant produire jusqu’à 2K, il est préautorisé au palier 2K.
Exemple : une entrée
1080×1080 est décomposée en 10 images. La tâche est préautorisée pour 17 images × palier 2K. Si les 10 images finales ne dépassent pas 2,61 millions de pixels, la facturation porte sur 10 images × palier 1K et le crédit restant est remboursé automatiquement.Erreurs courantes
⏱️ Génération plus lente : environ 90 s en 1K et 160 s en 2K (priorité à la qualité). Interrogez l’état de la tâche toutes les 5 à 10 secondes et réglez le délai du client sur 5 minutes. Enregistrez rapidement les résultats générés.
Response
integer
Code de statut de la réponse
array
Tableau de données de la réponse