Passer au contenu principal
POST
/
v1
/
images
/
generations
Interface doubao-seedream-5.0-pro
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedream-5.0-pro",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5pro",
  "model": "doubao-seedream-5.0-pro",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1.8,
    "user_group": "default"
  }
}

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 :

Authorization: Bearer YOUR_API_KEY

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, limitée à 2000 tokens

Maximum string length: 2000
Exemple:

"A serene lake reflecting the beautiful sunset"

​
n
integer

Nombre d'images à générer, Pro prend uniquement en charge 1

Remarque :

  • Chaque requête sera pré-facturée en fonction de la valeur de n, facturation réelle basée sur le nombre d'images générées
Exemple:

1

​
size
string
défaut:auto

Taille de l'image générée, prend en charge deux formats :

Méthode 1 - Format ratio :

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

Méthode 2 - Format pixel :

  • Largeur x Hauteur, par exemple : 1024x1024, 2048x2048 et autres valeurs dans la plage
  • Plage de pixels totale : [1024x1024, 2048x2048]
  • Plage de rapport d'aspect : [1/16, 16]

Par défaut auto lorsque size n'est pas fourni

Exemple:

"16:9"

​
quality
enum<string>
défaut:1K

Qualité de l'image générée

  • 1K : Résolution standard 1K
  • 2K : Résolution haute 2K

Pro par défaut 1K

Options disponibles:
1K,
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
Options disponibles:
standard
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 : pas plus de 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:
[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
​
model_params
object

Paramètres supplémentaires du modèle

​
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