Seedream 5.0 Lite Génération d'images

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-lite",
  "prompt": "Un bateau en papier sur un lac calme au coucher du soleil"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "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"
  }
}

{
  "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.0-lite",
    "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"
  }
}

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.0-lite",
  "prompt": "Un bateau en papier sur un lac calme au coucher du soleil"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5lite",
  "model": "doubao-seedream-5.0-lite",
  "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"
  }
}

{
  "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.0-lite",
    "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.0-lite

requis

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

Options disponibles:

doubao-seedream-5.0-lite

Exemple:

"doubao-seedream-5.0-lite"

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"

integer

Nombre maximum d'images à générer, prend en charge toute valeur entière entre [1,15]

Remarque :

Pour générer plusieurs images, incluez des prompts comme : "générer 2 images différentes" dans votre prompt
Nombre d'images de référence + nombre d'images générées finales ≤ 15 images
Si : nombre d'images de référence + images demandées dans le prompt > 15, et images demandées dans le prompt ≤ valeur du paramètre n, alors images générées finales = 15 - nombre d'images de référence
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 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: 2560x1440, 2048x2048, 4096x4096
Plage totale de pixels: [3686400, 16777216]
Plage de rapport d’aspect: [1/16, 16]

Exemple:

"16:9"

quality

enum<string>

défaut:2K

Niveau de résolution, utilisé avec le format de ratio de size.

Ratio	2K	3K	4K
`1:1`	2048×2048	3072×3072	4096×4096
`2:3`	1664×2496	2496×3744	3328×4992
`3:2`	2496×1664	3744×2496	4992×3328
`3:4`	1728×2304	2592×3456	3520×4704
`4:3`	2304×1728	3456×2592	4704×3520
`4:5`	1792×2240	2688×3360	3584×4480
`5:4`	2240×1792	3360×2688	4480×3584
`9:16`	1600×2848	2304×4096	3040×5504
`16:9`	2848×1600	4096×2304	5504×3040
`21:9`	3136×1344	4704×2016	6240×2656
`9:21`	1344×3136	2016×4704	2656×6240

Options disponibles:

2K,

3K,

4K

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 : 14 images
Taille d'image : pas plus de 10MB
Formats d'image pris en charge : .jpeg, .jpg, .png, .webp, .bmp, .tiff, .gif
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: 14

Exemple:

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

model_params

object

Paramètres supplémentaires du modèle

Show child attributes

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-1757165031-seedream5lite"

model

string

Nom du modèle réellement utilisé

Exemple:

"doubao-seedream-5.0-lite"

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.0 Lite Génération d'images

Autorisations

Corps

Réponse