> ## 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.5 décomposition en calques

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

- Seedream 5.5 Décomposition en calques (doubao-seedream-5.5-layerize) sépare une image en une image de fond et plusieurs calques indépendants
- Fournissez `1` image d’entrée. `prompt` est facultatif ; s’il est omis, le modèle identifie et sépare automatiquement les principaux éléments
- Utilisez `n` pour limiter le nombre d’images produites et `model_params.text_recognition` pour activer la reconnaissance de texte
- Traitement asynchrone : utilisez l’ID de tâche retourné pour [consulter son état](/fr/api-manual/task-management/get-task-detail)
- Les liens d'image générés sont valides pendant 24 heures, veuillez les enregistrer rapidement

### Détails de sortie

- `output_format` définit le format de l’image de fond. Les calques indépendants sont toujours des PNG avec canal alpha
- Chaque image de `result_data` comprend `z_index` (ordre d’empilement : `0` pour l’image de fond, à partir de `1` pour les calques) et `background` (`opaque` pour l’image de fond, `transparent` pour les calques). Les calques comprennent aussi `bounding_box` (`absolute` utilise les coordonnées en pixels de l’image de fond ; `normalized` va de `0` à `1000`), `name` et `description`
- Si un calque échoue, toute la tâche échoue avec remboursement intégral. Aucun résultat partiel n’est renvoyé

### Facturation

- L’image de fond et chaque calque sont facturés individuellement. L’image d’entrée est facturée séparément
- À la création de la tâche, des crédits sont réservés pour `1` image d’entrée et jusqu’à `n` images de sortie. À la fin, le montant est ajusté au nombre réel d’images produites et les crédits inutilisés sont automatiquement restitués



## OpenAPI

````yaml fr/api-manual/image-series/seedream-5.5/seedream-5.5-layerize-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface doubao-seedream-5.5-layerize
  description: >-
    Utiliser le modèle de décomposition en calques Seedream 5.5 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.5-layerize
      description: >-
        > 🚧 **Ce modèle n'est pas encore disponible, restez à l'écoute**


        - Seedream 5.5 Décomposition en calques (doubao-seedream-5.5-layerize)
        sépare une image en une image de fond et plusieurs calques indépendants

        - Fournissez `1` image d’entrée. `prompt` est facultatif ; s’il est
        omis, le modèle identifie et sépare automatiquement les principaux
        éléments

        - Utilisez `n` pour limiter le nombre d’images produites et
        `model_params.text_recognition` pour activer la reconnaissance de texte

        - Traitement asynchrone : utilisez l’ID de tâche retourné pour
        [consulter son état](/fr/api-manual/task-management/get-task-detail)

        - Les liens d'image générés sont valides pendant 24 heures, veuillez les
        enregistrer rapidement


        ### Détails de sortie


        - `output_format` définit le format de l’image de fond. Les calques
        indépendants sont toujours des PNG avec canal alpha

        - Chaque image de `result_data` comprend `z_index` (ordre d’empilement :
        `0` pour l’image de fond, à partir de `1` pour les calques) et
        `background` (`opaque` pour l’image de fond, `transparent` pour les
        calques). Les calques comprennent aussi `bounding_box` (`absolute`
        utilise les coordonnées en pixels de l’image de fond ; `normalized` va
        de `0` à `1000`), `name` et `description`

        - Si un calque échoue, toute la tâche échoue avec remboursement
        intégral. Aucun résultat partiel n’est renvoyé


        ### Facturation


        - L’image de fond et chaque calque sont facturés individuellement.
        L’image d’entrée est facturée séparément

        - À la création de la tâche, des crédits sont réservés pour `1` image
        d’entrée et jusqu’à `n` images de sortie. À la fin, le montant est
        ajusté au nombre réel d’images produites et les crédits inutilisés sont
        automatiquement restitués
      operationId: createSeedreamLayerizeImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              auto_layerize:
                summary: >-
                  Décomposition automatique (sans prompt) avec reconnaissance de
                  texte
                value:
                  model: doubao-seedream-5.5-layerize
                  image_urls:
                    - https://example.com/poster.png
                  quality: auto
                  output_format: png
                  'n': 30
                  model_params:
                    text_recognition: true
              prompt_layerize:
                summary: Indiquer les éléments en langage naturel
                value:
                  model: doubao-seedream-5.5-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.5-layerize
                  prompt: >-
                    texte du titre<bbox>179 58 809 197</bbox>, 1
                    perroquet<bbox>330 274 641 991</bbox>
                  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.5-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.5-layerize
          default: doubao-seedream-5.5-layerize
          example: doubao-seedream-5.5-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`)

            - L’image d’entrée est facturée séparément
          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 `<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
          example: Extraire le perroquet et le texte du titre
        'n':
          type: integer
          description: >-
            Nombre maximal d’images produites, image de fond comprise. Valeur
            par défaut : `30`.


            **Détails :**

            - Plage autorisée : de `2` à `100`. Les valeurs hors de cette plage
            renvoient `400` sans facturation

            - La décomposition s’arrête à cette limite ; les éléments restants
            peuvent être fusionnés ou omis. Une valeur plus élevée permet une
            séparation plus fine

            - Une valeur de `n` plus élevée réserve davantage de crédits. À la
            fin, le montant est ajusté au nombre réel d’images produites et les
            crédits inutilisés sont automatiquement restitués
          minimum: 2
          maximum: 100
          default: 30
          example: 30
        quality:
          type: string
          description: >-
            Résolution de sortie. Valeur par défaut : `auto`.


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


            **Remarques :**

            - Seules les options de résolution ci-dessus sont acceptées. Un
            ratio (comme `16:9`) ou des dimensions en pixels (comme `2048x2048`)
            renvoient 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
          enum:
            - auto
            - 1K
            - 1.5K
            - 2K
          default: auto
          example: auto
        prompt_priority:
          type: string
          description: >-
            Mode d’optimisation du prompt. Seul `standard` est accepté et
            constitue la valeur par défaut.


            La valeur `fast` renvoie `400` sans facturation.
          enum:
            - standard
          default: standard
          example: standard
        output_format:
          type: string
          description: >-
            Format de l’image de sortie


            **Options :**

            - `png` : Format PNG (par défaut)

            - `jpeg` : Format JPEG


            **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:
            - png
            - jpeg
          default: png
          example: png
        model_params:
          type: object
          description: >-
            Options supplémentaires de décomposition en calques. Seul
            `text_recognition` est accepté ; les autres clés renvoient `400`.
          properties:
            text_recognition:
              type: boolean
              description: >-
                Activer la reconnaissance de texte dans les calques de texte


                - `false` : Les calques comprennent uniquement `name`,
                `description` et `bounding_box` (par défaut)

                - `true` : Les calques contenant du texte régulier renvoient
                aussi `text_recognition` : le `text` complet (plusieurs lignes
                reliées par `\n`, d’abord de haut en bas, puis de gauche à
                droite), le `bounding_box` de chaque ligne, ainsi que le `text`
                et le `style` de chaque segment (`similar_font_family` pour une
                police similaire, `foreground_color` pour la couleur du texte,
                et les indicateurs de style `bold` / `italic` / `underline` /
                `strikethrough` / `shadow` / `translucent`)


                Les calques de texte artistique, manuscrit ou décoratif ne
                renvoient pas `text_recognition`.
              default: false
              example: true
        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-1793612934-seedream55layerize
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: doubao-seedream-5.5-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: 150
    Usage:
      type: object
      description: Informations d'utilisation et de facturation
      properties:
        billing_rule:
          type: string
          description: Règle de facturation
          enum:
            - per_call
            - per_image
            - per_token
            - per_second
          example: per_image
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 55.624
        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

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.