> ## 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 Flash Génération d'images

> - Seedream 5.0 Flash (doubao-seedream-5.0-flash) prend en charge la génération texte vers image, image vers image, la retouche et d’autres modes. Ses principaux paramètres correspondent à ceux de Seedream 5.0 Pro, avec une génération plus rapide et un prix plus bas
- Facturation par image : `1K`, `1.5K` et `2K` sont au même prix ; les images de référence sont gratuites
- Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [interroger](/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



## OpenAPI

````yaml fr/api-manual/image-series/seedream/seedream-5.0-flash-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface doubao-seedream-5.0-flash
  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.0-flash
      description: >-
        - Seedream 5.0 Flash (doubao-seedream-5.0-flash) prend en charge la
        génération texte vers image, image vers image, la retouche et d’autres
        modes. Ses principaux paramètres correspondent à ceux de Seedream 5.0
        Pro, avec une génération plus rapide et un prix plus bas

        - Facturation par image : `1K`, `1.5K` et `2K` sont au même prix ; les
        images de référence sont gratuites

        - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour
        [interroger](/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
      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.0-flash
                  prompt: Un lac paisible reflétant un magnifique coucher de soleil
                  size: '16:9'
                  quality: 2K
      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-flash
                  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.0-flash
          default: doubao-seedream-5.0-flash
          example: doubao-seedream-5.0-flash
        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.0 Flash 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: Un lac paisible reflétant un magnifique coucher de soleil
        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`


            Lorsque `size` n’est pas fourni, la valeur par défaut est `auto`.
            `auto` signifie qu'aucun ratio précis n'est imposé : le modèle
            détermine le cadrage à partir de l'invite et la résolution de sortie
            suit le niveau défini par `quality`.
          default: auto
          example: '16:9'
        quality:
          type: string
          description: >-
            Niveau de résolution, utilisé avec le format de ratio de `size` ; la
            valeur par défaut est `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 |


            **Facturation :**

            - Facturation par image, au même prix pour `1K`, `1.5K` et `2K` ;
            `1.5K` et `2K` offrent une meilleure qualité sans supplément

            - Le format en pixels de `size` est également facturé par image,
            sans tarification par paliers de pixels
          enum:
            - 1K
            - 1.5K
            - 2K
          default: 1K
          example: 2K
        prompt_priority:
          type: string
          description: >-
            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.
          enum:
            - standard
          default: standard
          example: standard
        image_urls:
          type: array
          description: >-
            Liste des URL d’images de référence pour la génération image vers
            image et la retouche


            **Remarques :**

            - Les images de référence sont gratuites

            - Jusqu’à `10` images d’entrée par requête

            - Taille de l’image : `30MB` maximum

            - Formats pris en charge : `.jpeg`, `.jpg`, `.png`, `.webp`, `.bmp`,
            `.tiff`, `.gif`, `.heic`, `.heif`

            - Rapport largeur/hauteur : `[1/16, 16]`

            - La largeur et la hauteur doivent toutes deux être supérieures à
            `14px`

            - Nombre total de pixels : `[196, 6000×6000]`

            - Les URL des images doivent être directement accessibles au serveur
            ou déclencher un téléchargement direct à l’ouverture (elles se
            terminent généralement par une extension d’image telle que `.png` ou
            `.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

            - `jpeg` : format JPEG


            **Remarque :** avec `background=transparent`, la sortie est toujours
            en png : si `output_format` est omis, png est sélectionné
            automatiquement ; la valeur `jpeg` est refusée.
          enum:
            - png
            - jpeg
          default: jpeg
          example: jpeg
        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: >-
            Réglage du canal de transparence


            **Options :**

            - `opaque` : fond opaque classique (par défaut)

            - `transparent` : conserver le canal alpha existant de l’image
            d’entrée


            > `transparent` **conserve** le fond transparent déjà présent dans
            l’image d’entrée ; il **ne supprime pas l’arrière-plan**.


            **Restrictions (uniquement pour `transparent`) :**

            - Exactement 1 image d’entrée est requise

            - L’entrée doit être un **PNG** comportant au moins un pixel
            transparent ; webp, jpeg, les autres formats et les PNG sans pixels
            transparents sont refusés par le modèle (les tâches échouées sont
            intégralement remboursées)

            - La sortie est toujours en png : si `output_format` est omis, png
            est sélectionné automatiquement ; `output_format=jpeg` est refusé
          enum:
            - opaque
            - transparent
          default: opaque
          example: opaque
        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-seedream5flash
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: doubao-seedream-5.0-flash
        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: 20
    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.1016
        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

        ```

````