> ## 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 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](/fr/api-manual/task-management/get-task-detail)
- 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



## OpenAPI

````yaml fr/api-manual/image-series/seedream-5.5/seedream-5.5-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface doubao-seedream-5.5
  description: >-
    Créer des tâches d'images en utilisant des modèles IA, prenant en charge
    plusieurs modèles et configurations de paramètres
  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
      description: >-
        > 🚧 **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](/fr/api-manual/task-management/get-task-detail)

        - 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
      operationId: createImageGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Texte vers image
                value:
                  model: doubao-seedream-5.5
                  prompt: A serene lake reflecting the beautiful sunset
                  size: '16:9'
                  quality: 2K
              transparent_text_to_image:
                summary: Texte vers image avec arrière-plan transparent
                value:
                  model: doubao-seedream-5.5
                  prompt: >-
                    Un autocollant de chaton orange en dessin animé sur fond
                    transparent
                  size: '1:1'
                  quality: 1K
                  background: transparent
      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'
                  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
        - prompt
      properties:
        model:
          type: string
          description: Nom du modèle de génération d'image
          enum:
            - doubao-seedream-5.5
          default: doubao-seedream-5.5
          example: doubao-seedream-5.5
        prompt:
          type: string
          description: >-
            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.
          example: A serene lake reflecting the beautiful sunset
        size:
          type: string
          description: >-
            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.
          default: auto
          example: '16:9'
        quality:
          type: string
          description: >-
            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 |
          enum:
            - 1K
            - 1.5K
            - 2K
          default: 1K
          example: 2K
        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
        image_urls:
          type: array
          description: >-
            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`)
          items:
            type: string
            format: uri
          maxItems: 10
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        output_format:
          type: string
          description: >-
            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.
          enum:
            - png
            - jpeg
          default: png
          example: png
        watermark:
          type: boolean
          description: Indique s’il faut ajouter un filigrane à l’image générée
          default: false
          example: false
        background:
          type: string
          description: >-
            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
          enum:
            - auto
            - transparent
            - opaque
          default: auto
          example: auto
        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-1793612886-seedream55
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: doubao-seedream-5.5
        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: 45
    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: 1.836
        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.