> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Seedream 5.0 Pro décomposition en calques
> - Seedream 5.0 Pro décomposition en calques (doubao-seedream-5.0-pro-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](/fr/api-manual/task-management/get-task-detail). 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`
- Ce modèle est plus lent qu'une génération simple : environ `120` secondes
- Les liens d'image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement
## OpenAPI
````yaml fr/api-manual/image-series/seedream/seedream-5.0-pro-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
title: Interface doubao-seedream-5.0-pro-layerize
description: >-
Utiliser le modèle de décomposition en calques Seedream 5.0 Pro pour diviser
une image en une image de fond et plusieurs calques modifiables
license:
name: MIT
version: 1.0.0
servers:
- url: https://api.evolink.ai
description: Environnement de production
security:
- bearerAuth: []
tags:
- name: Génération d'image
description: APIs liées à la génération d'images IA
paths:
/v1/images/generations:
post:
tags:
- Génération d'image
summary: Interface doubao-seedream-5.0-pro-layerize
description: >-
- Seedream 5.0 Pro décomposition en calques
(doubao-seedream-5.0-pro-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](/fr/api-manual/task-management/get-task-detail). 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`
- Ce modèle est plus lent qu'une génération simple : environ `120`
secondes
- Les liens d'image générés sont valides pendant 24 heures, veuillez les
enregistrer rapidement
operationId: createSeedreamLayerizeImageGeneration
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationRequest'
examples:
auto_layerize:
summary: Décomposition automatique (sans invite)
value:
model: doubao-seedream-5.0-pro-layerize
image_urls:
- https://example.com/poster.png
quality: auto
output_format: jpeg
prompt_layerize:
summary: Indiquer les éléments en langage naturel
value:
model: doubao-seedream-5.0-pro-layerize
prompt: Extraire le perroquet et le texte du titre
image_urls:
- https://example.com/poster.png
quality: 2K
bbox_layerize:
summary: Indiquer avec des coordonnées bbox
value:
model: doubao-seedream-5.0-pro-layerize
prompt: >-
texte du titre179 58 809 197, 1
perroquet330 274 641 991
image_urls:
- https://example.com/poster.png
quality: 1.5K
responses:
'200':
description: Tâche de génération d'image créée avec succès
content:
application/json:
schema:
$ref: '#/components/schemas/ImageGenerationResponse'
'400':
description: Paramètres de requête invalides
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: invalid_request
message: Invalid request parameters
type: invalid_request_error
'401':
description: Non authentifié, jeton invalide ou expiré
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: unauthorized
message: Invalid or expired token
type: authentication_error
'402':
description: Quota insuffisant, recharge requise
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: insufficient_quota
message: Insufficient quota. Please top up your account.
type: insufficient_quota
'403':
description: Accès refusé
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: model_access_denied
message: >-
Token does not have access to model:
doubao-seedream-5.0-pro-layerize
type: invalid_request_error
'429':
description: Limite de débit dépassée
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: rate_limit_exceeded
message: Too many requests, please try again later
type: rate_limit_error
'500':
description: Erreur interne du serveur
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: internal_error
message: Internal server error
type: api_error
components:
schemas:
ImageGenerationRequest:
type: object
required:
- model
- image_urls
properties:
model:
type: string
description: Nom du modèle de génération d'image
enum:
- doubao-seedream-5.0-pro-layerize
default: doubao-seedream-5.0-pro-layerize
example: doubao-seedream-5.0-pro-layerize
image_urls:
type: array
description: >-
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`)
items:
type: string
format: uri
minItems: 1
maxItems: 1
example:
- https://example.com/poster.png
prompt:
type: string
description: >-
É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 `` pour
préciser la position, par ex. `texte du titre179 58 809
197` ; les coordonnées normalisées (`0`~`1000`) sont
recommandées
example: Extraire le perroquet et le texte du titre
quality:
type: string
description: >-
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 :** le niveau est déterminé pour chaque image de
sortie selon son propre nombre de pixels ; `1K` et `1.5K` sont au
même prix, et une image de sortie dépassant `2610000` pixels est
facturée au niveau supérieur.
enum:
- auto
- 1K
- 1.5K
- 2K
default: auto
example: auto
prompt_priority:
type: string
description: >-
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
enum:
- standard
- fast
default: standard
example: standard
output_format:
type: string
description: >-
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.
enum:
- jpeg
- png
default: jpeg
example: jpeg
callback_url:
type: string
description: >-
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
format: uri
example: https://your-domain.com/webhooks/image-task-completed
ImageGenerationResponse:
type: object
properties:
created:
type: integer
description: Horodatage de création de la tâche
example: 1757165031
id:
type: string
description: ID de tâche
example: task-unified-1757165031-seedream5prolayerize
model:
type: string
description: Nom du modèle réellement utilisé
example: doubao-seedream-5.0-pro-layerize
object:
type: string
enum:
- image.generation.task
description: Type de tâche spécifique
progress:
type: integer
description: Pourcentage de progression de la tâche (0-100)
minimum: 0
maximum: 100
example: 0
status:
type: string
description: Statut de la tâche
enum:
- pending
- processing
- completed
- failed
example: pending
task_info:
$ref: '#/components/schemas/TaskInfo'
description: Informations sur la tâche asynchrone
type:
type: string
enum:
- text
- image
- audio
- video
description: Type de sortie de la tâche
example: image
usage:
$ref: '#/components/schemas/Usage'
description: Informations d'utilisation et de facturation
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
description: Identifiant du code d'erreur
message:
type: string
description: Description de l'erreur
type:
type: string
description: Type d'erreur
TaskInfo:
type: object
properties:
can_cancel:
type: boolean
description: Si la tâche peut être annulée
example: true
estimated_time:
type: integer
description: Temps d'achèvement estimé (secondes)
minimum: 0
example: 120
Usage:
type: object
description: Informations d'utilisation et de facturation
properties:
billing_rule:
type: string
description: Règle de facturation
enum:
- per_call
- per_token
- per_second
example: per_call
credits_reserved:
type: number
description: Crédits estimés consommés
minimum: 0
example: 39.168
user_group:
type: string
description: Catégorie de groupe d'utilisateurs
example: default
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
##Toutes les API nécessitent une authentification Bearer Token##
**Obtenir une clé API :**
Visitez la [Page de gestion des clés
API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API
**Ajouter à l'en-tête de requête :**
```
Authorization: Bearer YOUR_API_KEY
```
````