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.5",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Seedream 5.5

Seedream 5.5 Génération d'images

🚧 Ce modèle n’est pas encore disponible, restez à l’écoute

Seedream 5.5 (doubao-seedream-5.5) prend en charge le texte vers image, l’image vers image et la retouche d’images, y compris les arrière-plans transparents
Traitement asynchrone : utilisez l’ID de tâche retourné pour consulter son état
Les liens des images générées sont valides pendant 24 heures ; enregistrez les images rapidement

Facturation

La facturation dépend du nombre réel d’images générées
Les images de référence sont facturées séparément des images générées

POST

images

generations

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.5",
  "prompt": "A serene lake reflecting the beautiful sunset",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1793612886-seedream55",
  "model": "doubao-seedream-5.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 1.836,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: doubao-seedream-5.5",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

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.5

requis

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

Options disponibles:

doubao-seedream-5.5

Exemple:

"doubao-seedream-5.5"

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.5 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

Sans size, la valeur par défaut est auto. Le modèle détermine le ratio à partir du prompt et quality définit la résolution de sortie.

Exemple:

"16:9"

quality

enum<string>

défaut:1K

Résolution de sortie, utilisée avec le format de ratio de size. Valeur par défaut : 1K.

Ratio	1K	1.5K	2K
`1:1`	1024×1024	1536×1536	2048×2048
`2:3`	832×1248	1248×1872	1664×2496
`3:2`	1248×832	1872×1248	2496×1664
`3:4`	864×1152	1344×1792	1776×2368
`4:3`	1152×864	1792×1344	2368×1776
`4:5`	896×1120	1344×1680	1792×2240
`5:4`	1120×896	1680×1344	2240×1792
`9:16`	800×1424	1152×2048	1584×2816
`16:9`	1424×800	2048×1152	2816×1584
`21:9`	1568×672	2352×1008	3136×1344
`9:21`	672×1568	1008×2352	1344×3136

Options disponibles:

1K,

1.5K,

2K

Exemple:

"2K"

prompt_priority

enum<string>

défaut:standard

Mode d’optimisation du prompt. Seul standard est accepté et constitue la valeur par défaut.

La valeur fast renvoie 400 sans facturation.

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 :

Les images de référence sont facturées séparément des images générées
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:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

output_format

enum<string>

défaut:png

Format de l’image de sortie

Options :

png : Format PNG (par défaut)
jpeg : Format JPEG

Remarque : Avec background=transparent, la sortie est toujours en png : sans output_format, le format png est utilisé automatiquement ; la valeur jpeg est rejetée.

Options disponibles:

png,

jpeg

Exemple:

"png"

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:auto

Type d’arrière-plan de l’image produite. Valeur par défaut : auto.

Options :

auto : Le modèle détermine l’arrière-plan à partir du prompt et des images de référence. result_data[].background dans le détail de la tâche renvoie le type réel : transparent ou opaque
transparent : Génère un PNG avec canal alpha. Compatible avec le texte vers image et l’image vers image
opaque : Génère une image avec un arrière-plan opaque

Avec transparent :

Les images de référence sont facultatives. Jusqu’à 10 images sont acceptées, sans obligation de canal alpha
Le format de sortie doit être png. Sans output_format, png est utilisé automatiquement ; la valeur jpeg renvoie une erreur

Options disponibles:

auto,

transparent,

opaque

Exemple:

"auto"

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

string

ID de tâche

Exemple:

"task-unified-1793612886-seedream55"

model

string

Nom du modèle réellement utilisé

Exemple:

"doubao-seedream-5.5"

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

Show child attributes

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

Show child attributes

Série Image

Série Vidéo

Série Audio

Série Texte

Gestion du compte

Gestion des tâches

Gestion des fichiers

Seedream 5.5 Génération d'images

Facturation

Autorisations

Corps

Réponse