Skip to main content
POST
Interface doubao-seedream-5.0-pro

Autorisations

Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Corps

application/json
model
enum<string>
défaut:doubao-seedream-5.0-pro
requis

Nom du modèle de génération d'image

Options disponibles:
doubao-seedream-5.0-pro
Exemple:

"doubao-seedream-5.0-pro"

prompt
string
requis

Invite décrivant l'image que vous souhaitez générer, ou décrivant comment éditer l'image d'entrée

Langues prises en charge : outre le chinois et l'anglais, Seedream 5.0 Pro prend en charge le russe, l'arabe, le philippin, 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.

Limite de longueur : jusqu'à 4000 tokens (environ 2 600 caractères chinois ou 5 000 mots anglais) ; au-delà, une erreur 400 est renvoyée et rien n'est facturé.

Recommandation : ne pas dépasser 300 caractères chinois ou 600 mots anglais. Une invite plus longue reste dans la limite mais dilue l'information : le modèle risque d'ignorer des détails et d'omettre des éléments de l'image.

Exemple:

"A serene lake reflecting the beautiful sunset"

size
string
défaut:auto

Taille de l’image générée ; prend en charge deux formats :

Méthode 1 - Format de ratio :

  • auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
  • Utilisé avec le paramètre quality, le système génère automatiquement une image avec le ratio et la résolution correspondants, sans spécifier manuellement les pixels

Méthode 2 - Format en pixels :

  • Largeur x hauteur, par exemple: 1024x1024, 2048x2048
  • Plage totale de pixels: [921600, 4624220]
  • Plage de rapport d’aspect: [1/16, 16]
  • La largeur et la hauteur doivent toutes deux être supérieures à 14px

Lorsque size n’est pas fourni, la valeur par défaut est auto. auto signifie qu'aucun ratio précis n'est imposé : le modèle détermine le cadrage à partir de l'invite et la résolution de sortie suit le niveau défini par quality.

Exemple:

"16:9"

quality
enum<string>
défaut:1K

Niveau de résolution, utilisé avec le format de ratio de size ; la valeur par défaut est 1K.

Facturation :

  • 1K et 1.5K sont au même prix ; 1.5K offre une meilleure qualité et est donc à privilégier
  • Avec le format en pixels de size, le niveau dépend du nombre total de pixels réellement produits : jusqu'à 2610000, le tarif bas s'applique ; au-delà, le tarif haut
Options disponibles:
1K,
1.5K,
2K
Exemple:

"2K"

prompt_priority
enum<string>
défaut:standard

Stratégie d'optimisation d'invite, utilisée pour définir le mode d'optimisation d'invite

Options :

  • standard : Mode standard, sortie de meilleure qualité, temps de traitement plus long
  • fast : Mode rapide, temps de traitement plus court, qualité légèrement inférieure au mode standard
Options disponibles:
standard,
fast
Exemple:

"standard"

image_urls
string<uri>[]

Liste d'URL d'images de référence pour les fonctionnalités image vers image et édition d'image

Remarque :

  • Une seule requête prend en charge la quantité d'images d'entrée : 10 images
  • Taille d'image : pas plus de 30MB
  • Formats d'image pris en charge : .jpeg, .jpg, .png, .webp, .bmp, .tiff, .gif, .heic, .heif
  • Plage de rapport d'aspect (largeur/hauteur) : [1/16, 16]
  • Largeur et hauteur (px) > 14
  • Total de pixels : [196, 6000×6000]
  • Les URL d'images doivent être directement visibles par le serveur, ou l'URL de l'image doit déclencher un téléchargement direct lors de l'accès (généralement ces URL se terminent par des extensions de fichiers image, telles que .png, .jpg)
Maximum array length: 10
Exemple:
output_format
enum<string>
défaut:jpeg

Format de sortie de l'image générée

Remarque : avec background=transparent, la sortie est toujours en png ; transmettre en même temps output_format=jpeg est rejeté.

Options disponibles:
png,
jpeg
Exemple:

"jpeg"

watermark
boolean
défaut:false

Indique s’il faut ajouter un filigrane à l’image générée

Exemple:

false

background
enum<string>
défaut:opaque

Commutateur de couche de transparence

Options :

  • opaque : Fond plein classique (par défaut)
  • transparent : Conserve la couche alpha que possède déjà l'image d'entrée

transparent conserve le fond transparent que possède déjà l'image d'entrée ; il ne s'agit pas d'un détourage ni d'une suppression de fond.

Limitations (uniquement pour transparent) :

  • Une seule image d'entrée doit être fournie, et elle doit posséder une couche alpha
  • La sortie est toujours en png ; transmettre en même temps output_format=jpeg est rejeté
  • Les images d'entrée dans des formats sans couche alpha (comme jpeg) sont rejetées par le modèle
Options disponibles:
opaque,
transparent
Exemple:

"opaque"

callback_url
string<uri>

Adresse de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

  • Déclenché lorsque la tâche est terminée, échouée ou annulée
  • Envoyé après confirmation de la facturation

Restrictions de sécurité :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP internes sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum 3 tentatives en cas d'échec (tentatives après 1 seconde/2 secondes/4 secondes)
  • Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de requête de tâche
  • Un code de statut 2xx renvoyé par l'adresse de rappel est considéré comme un succès, les autres codes de statut déclenchent une nouvelle tentative
Exemple:

"https://your-domain.com/webhooks/image-task-completed"

Réponse

Tâche de génération d'image créée avec succès

created
integer

Horodatage de création de la tâche

Exemple:

1757165031

id
string

ID de tâche

Exemple:

"task-unified-1757165031-seedream5pro"

model
string

Nom du modèle réellement utilisé

Exemple:

"doubao-seedream-5.0-pro"

object
enum<string>

Type de tâche spécifique

Options disponibles:
image.generation.task
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

task_info
object

Informations sur la tâche asynchrone

type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"image"

usage
object

Informations d'utilisation et de facturation