> ## 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.

# Qwen Image 3.0 Pro

> > 🚧 **Ce modele n'est pas encore disponible, restez a l'ecoute**

- Le modèle Qwen (qwen-image-3.0-pro) prend en charge deux modes : génération d'image à partir de texte (T2I, sans image de référence) et édition d'image (I2I, avec 1 à 3 images de référence)
- 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/qwen/qwen-image-3.0-pro.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Interface qwen-image-3.0-pro
  description: >-
    Utilisez le modèle Qwen pour l'édition d'images avec une configuration
    simplifiée des paramètres du modèle
  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 qwen-image-3.0-pro
      description: >-
        > 🚧 **Ce modele n'est pas encore disponible, restez a l'ecoute**


        - Le modèle Qwen (qwen-image-3.0-pro) prend en charge deux modes :
        génération d'image à partir de texte (T2I, sans image de référence) et
        édition d'image (I2I, avec 1 à 3 images de référence)

        - 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: createQwenImage30ProGeneration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QwenImageEditRequest'
            examples:
              text_to_image:
                summary: Génération à partir de texte (T2I, sans image de référence)
                value:
                  model: qwen-image-3.0-pro
                  prompt: >-
                    Un chat roux portant un casque d'astronaute, sur un fond
                    néon cyberpunk
              image_edit:
                summary: Édition d'image (I2I, avec 1 à 3 images de référence)
                value:
                  model: qwen-image-3.0-pro
                  prompt: Remplacez l'arrière-plan de cette image
                  image_urls:
                    - https://example.com/image1.png
      responses:
        '200':
          description: Tâche 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: qwen-image-3.0-pro'
                  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:
    QwenImageEditRequest:
      type: object
      required:
        - model
        - prompt
      properties:
        model:
          type: string
          description: Nom du modèle
          enum:
            - qwen-image-3.0-pro
          default: qwen-image-3.0-pro
          example: qwen-image-3.0-pro
        prompt:
          type: string
          description: >-
            Invite décrivant l'image à générer (génération à partir de texte) ou
            la manière d'éditer l'image fournie (édition d'image). Limitée à
            4500 tokens
          example: Remplacez l'arrière-plan de cette image
          maxLength: 4500
        image_urls:
          type: array
          description: >-
            Liste d'URLs d'images de référence (**facultatif**). Sans valeur ou
            tableau vide = génération à partir de texte (T2I) ; 1 à 3 images =
            édition d'image (I2I)


            **Remarque :**

            - Nombre d'images d'entrée prises en charge par requête : `0-3`
            images, au-delà de 3 une erreur sera renvoyée

            - Seules les URLs d'images http/https publiques sont prises en
            charge, base64 / data-url ne le sont pas

            - La largeur et la hauteur de l'image doivent être dans la plage de
            `[384-3072]` pixels

            - Formats de fichiers pris en charge : `.jpg`, `.jpeg`, `.png`,
            `.bmp`, `.webp`, `.tiff`

            - Les URLs d'images doivent être directement accessibles par le
            serveur, ou l'URL de l'image doit télécharger directement lors de
            l'accès (généralement ces URLs se terminent par des extensions de
            fichiers image, telles que `.png`, `.jpg`)
          items:
            type: string
            format: uri
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        'n':
          type: integer
          description: >-
            Spécifie le nombre d'images à générer, prend en charge toute valeur
            entière entre `[1,6]`


            **Remarque :**

            - Chaque requête sera pré-facturée en fonction de la valeur de `n`,
            les frais réels sont basés sur le nombre d'images générées
          minimum: 1
          maximum: 6
          default: 1
          example: 1
        negative_prompt:
          type: string
          description: >-
            Prompt négatif pour décrire le contenu que vous ne voulez pas voir
            dans l'image, utilisé pour contraindre la sortie


            **Remarque :**

            - Prend en charge le chinois et l'anglais, longueur maximale de
            `500` caractères, chaque caractère chinois/lettre compte comme un
            caractère, l'excédent sera automatiquement tronqué
          maxLength: 500
          example: >-
            low resolution, error, worst quality, low quality, mutilated, extra
            fingers, bad proportions
        size:
          type: string
          description: >-
            Taille de l'image générée, `auto` par défaut :

            - `auto` (par défaut) : le modèle choisit automatiquement une taille
            de sortie appropriée

            - `largeurxhauteur` : par exemple `1024x1024`, `1024x1536`,
            `1536x1024`, etc., la largeur et la hauteur étant toutes deux dans
            la plage `[512, 2048]` pixels


            **Remarque :**

            - La spécification explicite de la taille n'est disponible que
            lorsque le nombre d'images de sortie `n` est `1`, sinon une erreur
            sera renvoyée ; `auto` n'est pas soumis à cette limite
          default: auto
          example: 1024x1024
        prompt_extend:
          type: boolean
          description: >-
            S'il faut activer la réécriture intelligente du prompt. La valeur
            par défaut est `false` (ne réécrit pas le prompt de l'utilisateur de
            sa propre initiative) ; passez explicitement `true` pour utiliser un
            grand modèle afin d'optimiser le prompt positif, avec une
            amélioration notable pour les prompts simples ou insuffisamment
            descriptifs
          default: false
          example: true
        watermark:
          type: boolean
          description: >-
            S'il faut ajouter le filigrane "Qwen-Image" dans le coin inférieur
            droit de l'image. La valeur par défaut est `false`
          default: false
          example: false
        seed:
          type: integer
          description: >-
            Graine aléatoire, plage `[0, 2147483647]`, l'utilisation de la même
            valeur de graine peut maintenir le contenu généré relativement
            stable


            **Remarque :**

            - Si non fournie, l'algorithme utilisera automatiquement une graine
            aléatoire

            - Le processus de génération du modèle est probabiliste, même avec
            la même graine, les résultats ne peuvent pas être garantis
            complètement identiques à chaque fois
          minimum: 0
          maximum: 2147483647
          example: 12345
        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: 1757156493
        id:
          type: string
          description: ID de tâche
          example: task-unified-1757156493-imcg5zqt
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: qwen-image-3.0-pro
        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: 30
    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
        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

        ```

````