> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedream-4.0 Génération d'images

> - Le modèle Seedream 4.0 (doubao-seedream-4.0) prend en charge les modes texte-vers-image, image-vers-image, édition d'image et autres modes de génération
- 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-4.0-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface doubao-seedream-4.0
  description: >-
    Créer des tâches d'images en utilisant des modèles IA avec prise en charge
    de 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-4.0
      description: >-
        - Le modèle Seedream 4.0 (doubao-seedream-4.0) prend en charge les modes
        texte-vers-image, image-vers-image, édition d'image et autres modes de
        génération

        - 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-4.0
                  prompt: A serene lake reflecting the beautiful sunset scenery
      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-4.0'
                  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-4.0
          default: doubao-seedream-4.0
          example: doubao-seedream-4.0
        prompt:
          type: string
          description: >-
            Invite décrivant l'image à générer, ou décrivant comment éditer
            l'image d'entrée, limitée à 2000 tokens
          example: A serene lake reflecting the beautiful sunset scenery
          maxLength: 2000
        'n':
          type: integer
          description: >-
            Spécifie la limite supérieure du nombre d'images à générer, prend en
            charge toute valeur entière entre `[1,15]`


            **Remarque :**

            - Si vous devez générer plusieurs images, veuillez inclure dans le
            prompt : " `generate 2 different images` " ou des instructions
            similaires


            - Nombre d'images de référence + nombre d'images générées finales ≤
            15


            - Si : nombre d'images de référence + images requises dans le prompt
            > 15, et images requises dans le prompt ≤ valeur du paramètre n,
            alors nombre d'images générées finales = 15 - nombre d'images de
            référence

            - Une seule requête sera pré-facturée en fonction de la valeur de
            `n`, la facturation réelle est basée sur le nombre d'images générées
          example: 1
        size:
          type: string
          description: >-
            Taille des images générées, prend en charge deux formats :


            **Méthode 1 - Format simplifié :**

            - `1K`, `2K`, `4K`

            - Décrivez le rapport d'aspect/forme/objectif dans le prompt, le
            modèle déterminera automatiquement la taille optimale


            **Méthode 2 - Format pixel :**

            - Largeur x hauteur, par exemple : `1280x720`, `1024x1024`,
            `4096x4096` et autres valeurs dans la plage

            - Plage de pixels totale : `[1280x720, 4096x4096]`

            - Plage de rapport d'aspect : `[1/16, 16]`
          example: 2048x2048
        prompt_priority:
          type: string
          description: >-
            Stratégie d'optimisation d'invite pour définir le mode de la
            fonction d'optimisation d'invite


            **Options :**

            - `standard` : Mode standard, sortie de meilleure qualité, temps de
            traitement plus long

            - `fast` : Mode rapide, vitesse de génération plus rapide, qualité
            moyenne
          enum:
            - standard
            - fast
          default: standard
          example: standard
        image_urls:
          type: array
          description: >-
            Liste d'URL d'images de référence pour les fonctions image vers
            image et édition d'image


            **Remarque :**

            - Nombre maximum d'images d'entrée par requête : `14`

            - Taille d'image : ne dépassant pas `10MB`

            - Formats d'image pris en charge : `.jpeg`, `.jpg`, `.png`, `.webp`,
            `.bmp`, `.tiff`, `.gif`

            - Plage de rapport d'aspect (largeur/hauteur) : `[1/16, 16]`

            - Largeur/hauteur (px) > 14

            - Total de pixels : ne dépassant pas `6000×6000`

            - Les URL d'images doivent être directement accessibles 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: 14
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        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-seedream4d
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: doubao-seedream-4.0
        object:
          type: string
          enum:
            - image.generation.task
          description: Type spécifique de la tâche
        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_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 1.8
        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

        ```

````