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-flash-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5flashlayerize",
  "model": "doubao-seedream-5.0-flash-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 60
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 18.7272,
    "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-flash-layerize",
    "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.0 Flash

Seedream 5.0 Flash décomposition en calques

Seedream 5.0 Flash décomposition en calques (doubao-seedream-5.0-flash-layerize) divise une image en une image de fond et plusieurs calques indépendants ; chaque calque est un PNG avec couche alpha, tandis que le format de l’image de fond suit output_format
Exactement une image d’entrée est requise ; prompt est facultatif : sans invite, le modèle détecte automatiquement tous les éléments principaux de l’image et les sépare un par un
Le nombre d’images en sortie dépend du résultat de la décomposition (1 ~ 17) et ne peut pas être contrôlé par les paramètres de la requête ; si un calque échoue, toute la requête échoue : il n’y a pas de succès partiel, et une requête en échec est intégralement remboursée
Mode de traitement asynchrone, utilisez l’ID de tâche retourné pour interroger. Dans le détail de la tâche, chaque élément de result_data porte un z_index (ordre d’empilement : 0 pour l’image de fond, à partir de 1 pour les calques) ; les calques portent en plus bounding_box (absolute en coordonnées pixel de l’image de fond, normalized dans la plage 0~1000), name et description
Facturation par image : l’image de base et chaque calque comptent chacun pour une image au même prix, quel que soit le niveau de résolution ; l’image d’entrée est gratuite. À la création de la tâche, des crédits sont réservés pour un maximum de 17 images. À la fin, la facturation est ajustée au nombre réel d’images produites et les crédits réservés en excès sont automatiquement restitués
Durée de traitement estimée : environ 60 secondes
Les liens d’image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement

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-flash-layerize",
  "image_urls": [
    "https://example.com/poster.png"
  ],
  "quality": "auto",
  "output_format": "jpeg"
}
'

{
  "created": 1757165031,
  "id": "task-unified-1757165031-seedream5flashlayerize",
  "model": "doubao-seedream-5.0-flash-layerize",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 60
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 18.7272,
    "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-flash-layerize",
    "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-flash-layerize

requis

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

Options disponibles:

doubao-seedream-5.0-flash-layerize

Exemple:

"doubao-seedream-5.0-flash-layerize"

image_urls

string<uri>[]

requis

URL de l'image à décomposer (obligatoire)

Remarque :

Exactement 1 image est requise ; l'omettre ou en transmettre 2 ou plus renvoie une erreur
Formats pris en charge : .png, .jpeg, .jpg (plus strict que la génération classique : webp et autres sont rejetés)
Taille d'image : pas plus de 30MB
Total de pixels : [262144, 6000×6000], soit au moins 512×512 (borne inférieure plus élevée que pour la génération classique)
Rapport d'aspect (largeur/hauteur) : [1/16, 16]
L'URL de l'image doit être directement consultable par le serveur, ou déclencher un téléchargement direct lors de l'accès (ces URL se terminent généralement par une extension de fichier image, telle que .png ou .jpg)

Required array length: 1 element

Exemple:

["https://example.com/poster.png"]

prompt

string

Éléments à extraire (facultatif)

Trois façons de l'utiliser :

L'omettre : le modèle détecte tous les éléments principaux de l'image et les sépare un par un
Langage naturel : par ex. Extraire le perroquet et le texte du titre ; les éléments sont identifiés sémantiquement et transformés en calques
Coordonnées exactes : utiliser des balises <bbox> pour préciser la position, par ex. texte du titre<bbox>179 58 809 197</bbox> ; les coordonnées normalisées (0~1000) sont recommandées

Exemple:

"Séparer le perroquet et le texte du titre"

quality

enum<string>

défaut:auto

Niveau de résolution de sortie, auto par défaut

Options : auto, 1K, 1.5K, 2K

Remarques :

Le mode calques n'accepte que des niveaux ; transmettre un ratio (comme 16:9) ou des pixels explicites (comme 2048x2048) renvoie une erreur
auto aligne la sortie sur l'image d'entrée : si la taille d'origine se situe dans [921600, 4624220] pixels, elle est conservée ; en dessous de 1K la sortie est en 1K, au-dessus de 2K elle est en 2K
Chaque calque conserve son propre rapport d'aspect issu de l'image d'origine, et l'image de fond conserve celui de l'entrée

Facturation : facturation par image, quel que soit le niveau de résolution ; 1K, 1.5K, 2K et auto sont au même prix.

Options disponibles:

auto,

1K,

1.5K,

2K

Exemple:

"auto"

prompt_priority

enum<string>

défaut:standard

Stratégie d’optimisation de l’invite, permettant de définir le mode d’optimisation

Options :

standard : mode standard

Remarque : Seedream 5.0 Flash ne prend en charge que standard ; fournir fast renvoie 400. Flash génère déjà les images plus rapidement et ne propose pas de mode rapide distinct.

Options disponibles:

standard

Exemple:

"standard"

output_format

enum<string>

défaut:jpeg

Format de l'image de sortie

Options :

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

Remarque : ce paramètre ne contrôle que l'image de fond. Les calques sont toujours en PNG avec couche alpha et ne sont pas concernés.

Options disponibles:

jpeg,

png

Exemple:

"jpeg"

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-seedream5flashlayerize"

model

string

Nom du modèle réellement utilisé

Exemple:

"doubao-seedream-5.0-flash-layerize"

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 Flash décomposition en calques

Autorisations

Corps

Réponse