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

# GPT Image 2.6 Génération d'images

> - GPT Image 2.6 (gpt-image-2.6-sunburst / gpt-image-2.6-flare) prend en charge le texte vers image, l'image vers image, l'édition d'images, l'édition guidée par annotations ainsi que la génération de GIF animés et de graphiques vectoriels SVG
- Traitement asynchrone : utilisez l'ID de tâche renvoyé pour [consulter son état](/fr/api-manual/task-management/get-task-detail)
- Les liens des images générées sont valables pendant 24 heures. Enregistrez les résultats dès que possible



## OpenAPI

````yaml fr/api-manual/image-series/gpt-image-2.6/gpt-image-2.6-image-generation.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: API gpt-image-2.6
  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: Production
security:
  - bearerAuth: []
tags:
  - name: Génération d'image
    description: API liées à la génération d'images par IA
paths:
  /v1/images/generations:
    post:
      tags:
        - Génération d'image
      summary: API gpt-image-2.6
      description: >-
        - GPT Image 2.6 (gpt-image-2.6-sunburst / gpt-image-2.6-flare) prend en
        charge le texte vers image, l'image vers image, l'édition d'images,
        l'édition guidée par annotations ainsi que la génération de GIF animés
        et de graphiques vectoriels SVG

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

        - Les liens des images générées sont valables pendant 24 heures.
        Enregistrez les résultats dès que possible
      operationId: createImageGenerationGptImage26
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Texte vers image (simple)
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: Un magnifique coucher de soleil coloré sur l'océan
              text_to_image_hd:
                summary: Texte vers image (HD 16:9)
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: >-
                    Plan large cinématographique d'une skyline urbaine futuriste
                    au crépuscule
                  size: '16:9'
                  resolution: 4K
                  quality: high
                  'n': 1
                  complexity: high
              text_to_image_pixel:
                summary: Texte vers image (pixels explicites)
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: Design de logo minimaliste
                  size: 1024x1024
                  quality: medium
              image_edit:
                summary: Image vers image / Édition
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: Ajoute un mignon chat à côté d'elle
                  size: '1:1'
                  resolution: 1K
                  quality: medium
                  image_urls:
                    - https://example.com/input.png
                  callback_url: https://your-domain.com/webhook/image-done
              image_inpaint:
                summary: Inpainting (avec masque)
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: Remplacez le ciel par un ciel étoilé
                  size: '1:1'
                  resolution: 1K
                  quality: medium
                  image_urls:
                    - https://example.com/input.png
                  mask_url: https://example.com/mask.png
              markup_edit:
                summary: Édition guidée par annotations (markup)
                value:
                  model: gpt-image-2.6-flare
                  prompt: >-
                    Transforme le vase entouré en rouge en un vase en céramique
                    bleu cobalt uni. Laisse le reste inchangé et supprime le
                    cercle rouge.
                  quality: medium
                  image_urls:
                    - https://example.com/kitchen.png
                  markup_url: https://example.com/markup.png
              batch_generation:
                summary: Génération par lot
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: Un robot mignon style pixel art
                  size: '1:1'
                  resolution: 2K
                  quality: high
                  'n': 4
              gif_animation:
                summary: GIF animé
                value:
                  model: gpt-image-2.6-flare
                  prompt: >-
                    Une lanterne se balance doucement dans le vent nocturne, en
                    boucle parfaitement fluide.
                  output_format: gif
                  size: auto
                  quality: medium
                  model_params:
                    frame_count: 9
                    frame_duration_ms: 200
              svg_vector:
                summary: Graphique vectoriel SVG
                value:
                  model: gpt-image-2.6-sunburst
                  prompt: >-
                    Un logo en flat design pour une boulangerie, avec des épis
                    de blé et un emblème circulaire.
                  output_format: svg
                  quality: medium
                  model_params:
                    svg_model: gpt-6.1-terra
              gif_animation_pixel:
                summary: GIF animé (dimensions de chaque frame)
                value:
                  model: gpt-image-2.6-flare
                  prompt: >-
                    Un petit chat cligne des yeux avec des mouvements naturels,
                    en boucle fluide.
                  output_format: gif
                  size: 720x720
                  quality: low
                  model_params:
                    frame_count: 16
                    frame_duration_ms: 200
      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: gpt-image-2.6-sunburst'
                  type: invalid_request_error
        '429':
          description: Limite de taux 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'images, offrant une meilleure
            stabilité et un meilleur contrôle pour les usages commerciaux


            | ID du modèle | Positionnement |

            |---|---|

            | `gpt-image-2.6-sunburst` | Meilleur rendu des détails, adapté aux
            créations visuelles exigeantes |

            | `gpt-image-2.6-flare` | Génération plus rapide, adaptée aux
            itérations rapides |


            Les deux modèles acceptent exactement les mêmes paramètres. À niveau
            `quality` identique, la consommation réelle de tokens peut
            légèrement varier ; référez-vous au `usage` renvoyé.
          enum:
            - gpt-image-2.6-sunburst
            - gpt-image-2.6-flare
          default: gpt-image-2.6-sunburst
          example: gpt-image-2.6-sunburst
        prompt:
          type: string
          description: >-
            Invite décrivant l'image à générer ou la manière de modifier l'image
            d'entrée


            **Limites de longueur (les deux doivent être respectées) :**

            - Jusqu'à `32 000` caractères (comptés en points de code Unicode)

            - Le texte de `prompt` lui-même ne doit pas dépasser `60 000` octets
            après encodage en UTF-8


            Les caractères peuvent occuper un nombre différent d'octets en
            UTF-8. Fiez-vous au nombre réel d'octets après encodage.


            Si l'une des limites est dépassée, raccourcissez l'invite avant de
            la renvoyer.


            **Recommandation :** Si l'invite dépasse `8000` tokens, l'image
            générée peut ne pas correspondre aux attentes ; il est recommandé de
            raccourcir l'invite.
          example: Un magnifique coucher de soleil coloré sur l'océan
          maxLength: 32000
        image_urls:
          type: array
          description: >-
            Liste des images de référence pour l'image vers image et l'édition
            d'images. Accepte les URL publiques.


            **Remarques :**

            - Nombre d'images en entrée par requête : `1–16`

            - Taille de fichier par image : au maximum `50MB`

            - Nombre de pixels par image : largeur × hauteur au maximum `178 956
            970` px

            - Longueur de chaque côté : largeur et hauteur au maximum `23170` px
            ; des valeurs supérieures peuvent provoquer des problèmes

            - Formats pris en charge : `.jpeg`, `.jpg`, `.png`, `.webp`

            - Lorsqu'une URL est utilisée, le serveur doit pouvoir accéder
            directement à l'image, ou le téléchargement doit commencer
            directement à l'ouverture de l'URL. Ces URL se terminent souvent par
            une extension d'image telle que `.png` ou `.jpg`.

            - Pour l'image vers image et l'édition, les images de référence
            entraînent une consommation supplémentaire de tokens d'entrée image.

            - Avec `markup_url`, les annotations s'appliquent à la première
            image ; les autres servent de références. La largeur × hauteur de la
            première image ne doit pas dépasser `16 777 216` px.

            - Les images de référence ne sont pas prises en charge avec
            `output_format=svg`.
          items:
            type: string
            format: uri
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        mask_url:
          type: string
          format: uri
          description: >-
            URL du masque d'inpainting — marque la région de l'image de
            référence à régénérer. **Valide uniquement en mode édition d'image**
            (doit être combiné avec `image_urls`) ; en texte-vers-image pur, le
            masque est silencieusement ignoré.


            **Exigences de format :**

            - **Doit être un PNG avec canal alpha** : pixels transparents
            (`alpha < 255`) = zones à régénérer, pixels opaques = préservés

            - **Les dimensions du masque doivent correspondre exactement à
            celles de l'image de référence** (largeur × hauteur en pixels)

            - Un seul masque par requête


            **Remarque :**

            - Au moins une image de référence est requise dans `image_urls` ; un
            masque seul n'a aucun effet

            - Erreurs courantes :
                - `Invalid mask image format - mask image missing alpha channel` : l'image téléchargée n'a pas de canal alpha (JPEG, PNG opaque, etc.). Réexportez le masque en PNG avec des régions transparentes.
                - `Invalid mask image format - mask size does not match image size` : les dimensions du masque ne correspondent pas à l'image de référence. Redimensionnez le masque aux mêmes dimensions en pixels que votre image de référence.
            - Ne peut pas être combiné avec `markup_url`.
          example: https://example.com/mask.png
        markup_url:
          type: string
          format: uri
          description: >-
            URL publique du calque d'annotations. Utilisez des cercles, des
            flèches ou des dessins pour indiquer les zones à modifier sur
            l'image de référence, et décrivez les changements dans `prompt`.
            **Disponible uniquement en mode édition d'image** (`image_urls` doit
            également être fourni).


            **Exigences de format :**

            - **PNG contenant des pixels transparents obligatoire** : dessinez
            uniquement les annotations et laissez le reste transparent. Ne
            dessinez pas directement sur l'image d'origine.

            - **Les dimensions doivent correspondre exactement à celles de la
            première image de référence** (largeur × hauteur en pixels).

            - La première image de référence et le calque d'annotations ne
            doivent pas dépasser `16 777 216` px chacun.

            - Taille de fichier : au maximum `50MB`


            **Remarques :**

            - Les annotations s'appliquent à la première image de `image_urls` ;
            les autres images servent de références.

            - Ne peut pas être combiné avec `mask_url`.

            - Prend en charge l'édition d'images classiques et de GIF, mais pas
            de SVG.

            - Peut aussi être fourni dans `model_params.markup_url`. Si les deux
            valeurs sont présentes, celle de premier niveau est prioritaire.

            - Précisez également dans `prompt` ce qui doit être conservé, par
            exemple « Laisse le reste inchangé et supprime le cercle rouge ».
          example: https://example.com/markup.png
        size:
          type: string
          description: >-
            Dimensions de l'image générée, `auto` par défaut. Les images
            classiques et les images de référence SVG suivent les règles
            ci-dessous ; les GIF suivent les règles distinctes de la section ④.


            **① Images classiques / images de référence SVG : format ratio (15
            possibilités)**


            - `1:1` : carré

            - `1:2` / `2:1` : très vertical / très horizontal

            - `1:3` / `3:1` : extrêmement vertical / horizontal (limite de 3:1)

            - `2:3` / `3:2` : portrait / paysage standard

            - `3:4` / `4:3` : portrait / paysage classique

            - `4:5` / `5:4` : formats courants pour les réseaux sociaux

            - `9:16` / `16:9` : écran large mobile / ordinateur

            - `9:21` / `21:9` : écran ultra-large


            **② Images classiques / images de référence SVG : dimensions
            explicites en pixels** : `WxH` (ou `W×H`), par exemple `1024x1024`,
            `1536x1024`, `3840×2160`


            - La largeur et la hauteur doivent être des multiples de `16`.

            - Plage de chaque côté : `[16, 3840]`

            - Budget de pixels : `655 360 ≤ width × height ≤ 8 294 400` (environ
            0,65 MP à 8,29 MP)

            - Ratio : `≤ 3:1`


            **③ Images classiques / images de référence SVG : `auto`** : le
            modèle détermine automatiquement les dimensions (`resolution` n'a
            alors aucun effet).


            **④ Sortie GIF** : `size` désigne les dimensions de chaque frame.
            Seuls `auto` et les dimensions explicites en pixels sont acceptés,
            pas les ratios.


            - Avec `auto`, chaque frame mesure `512×512`.

            - La largeur et la hauteur explicites de chaque frame doivent être
            des multiples positifs de `16`.

            - La limite minimale de `655 360` pixels des images classiques ne
            s'applique pas aux frames GIF individuelles. Par exemple, `512x512`
            est valide.

            - L'image composée de toutes les frames doit respecter les limites
            de longueur des côtés, de nombre total de pixels et de ratio.
            Consultez `model_params.frame_count` pour les dispositions et les
            limites par frame.

            - `resolution` n'a aucun effet.


            **En cas de dépassement :**

            - Si la combinaison du ratio et de `resolution` dépasse le budget
            d'une image classique / de référence SVG, elle est réduite
            proportionnellement jusqu'à la limite (par exemple, 4K 2:1 →
            3840×1920).

            - Des dimensions explicites de frame GIF dépassant les limites
            entraînent directement HTTP 400, sans réduction automatique.
          default: auto
          example: auto
        resolution:
          type: string
          description: >-
            Paramètre rapide de palier de résolution. Effectif uniquement
            lorsque `size` est au format ratio ; ignoré pour les dimensions
            explicites en pixels et les sorties GIF.


            **Règles de budget pixel** (les dimensions sont calculées à partir
            du nombre total de pixels cible et du ratio `size`, alignées sur des
            multiples de 16) :


            - `1K` : ~1 MP (1024² = 1 048 576 pixels)

            - `2K` : ~4 MP (2048² = 4 194 304 pixels)

            - `4K` : ~8,29 MP (3840×2160 = 8 294 400 pixels, le maximum)


            **Dimensions de sortie paysage / carré** (les dimensions portrait
            correspondent au paysage avec largeur/hauteur inversées, par exemple
            `2:3` = `3:2` inversé) :


            | Ratio | 1K | 2K | 4K |

            |---|---|---|---|

            | `1:1` | 1024×1024 | 2048×2048 | 2880×2880 |

            | `2:1` | 1456×720 | 2896×1456 | 3840×1920 \* |

            | `3:1` | 1776×592 | 3552×1184 | 3840×1280 \* |

            | `3:2` | 1248×832 | 2512×1680 | 3520×2352 |

            | `4:3` | 1184×880 | 2368×1776 | 3312×2480 \* |

            | `5:4` | 1152×912 | 2288×1824 | 3216×2576 |

            | `16:9` | 1360×768 | 2736×1536 | 3840×2160 (UHD) |

            | `21:9` | 1568×672 | 3136×1344 | 3840×1648 \* |


            \* Indique les combinaisons automatiquement réduites pour respecter
            le budget de pixels. Les valeurs sont insensibles à la casse.
          enum:
            - 1K
            - 2K
            - 4K
          default: 1K
          example: 1K
        quality:
          type: string
          description: >-
            Qualité du rendu, qui influence directement le nombre de tokens de
            sortie et le coût. Valeur par défaut : `medium`.


            | Valeur | Tokens de sortie (1024²) | Coût relatif de la sortie
            image (1024²) |

            |---|---|---|

            | `low` | 824 | ~0,57× |

            | `medium` | 1 449 | 1,0× |

            | `high` | 1 756 | ~1,21× |

            | `xhigh` | 3 122 | ~2,15× |

            | `max` | 7 024 | ~4,85× |


            **Remarques :**

            - Le tableau compare uniquement les coûts de sortie image, sans les
            coûts d'entrée ni ceux du modèle auteur SVG.

            - Ces valeurs sont calculées pour `1024×1024`. Le nombre de tokens
            de sortie varie selon le nombre total de pixels et le ratio.
            Référez-vous au `usage` renvoyé.

            - Pour un GIF, le calcul porte sur l'image composée de toutes les
            frames ; pour un SVG, ce paramètre s'applique à l'image de
            référence.

            - Utilisez `low` pour les brouillons rapides. Pour le résultat
            final, comparez plusieurs niveaux afin d'équilibrer détails, durée
            et coût.
          enum:
            - low
            - medium
            - high
            - xhigh
            - max
          default: medium
          example: medium
        complexity:
          type: string
          description: >-
            Profondeur de planification avant la génération de l'image,
            indépendante de `quality`. Valeur par défaut : `high`.


            - `low` : adapté aux modifications locales, comme changer un
            arrière-plan ou le texte d'une enseigne

            - `medium` : équilibré

            - `high` : adapté aux images riches en texte, aux mises en page
            complexes ou aux relations complexes entre objets


            **Remarques :**

            - Les niveaux élevés prennent plus de temps et peuvent introduire
            des modifications indésirables. Comparez les résultats selon la
            tâche.

            - Modifier `complexity` n'entraîne pas de facturation
            supplémentaire.

            - Pour un SVG, ce paramètre s'applique à l'image de référence.

            - Peut aussi être fourni dans `model_params.complexity`. Si les deux
            valeurs sont présentes, celle de premier niveau est prioritaire.
          enum:
            - low
            - medium
            - high
          default: high
          example: high
        background:
          type: string
          description: >-
            Canal d'arrière-plan de l'image de sortie, `opaque` par défaut.


            - `opaque` : arrière-plan opaque, sans canal alpha

            - `transparent` : conserve le canal alpha


            **Remarques :**

            - `transparent` est actuellement une fonctionnalité en Preview ; les
            résultats peuvent être instables.

            - Avec `transparent`, `output_format` doit être `png` ou `webp`.

            - Avec `output_format=gif` ou `svg`, seul `opaque` est accepté.
          enum:
            - opaque
            - transparent
          default: opaque
          example: opaque
        output_format:
          type: string
          description: >-
            Format du fichier de sortie, `png` par défaut.


            - `png` : sans perte, prend en charge les arrière-plans transparents

            - `jpeg` : compression avec perte pour réduire la taille du fichier

            - `webp` : compromis entre taille et qualité, avec prise en charge
            de la transparence

            - `gif` : GIF animé ; le nombre de frames et leur durée se
            définissent dans `model_params`

            - `svg` : graphique vectoriel SVG, adapté aux logos, icônes et
            autres formes nécessitant une mise à l'échelle sans perte


            **Remarques :**

            - Avec `background=transparent`, seuls `png` et `webp` sont
            acceptés.

            - `gif` prend en charge le texte vers image et l'édition d'images.

            - Pour `gif` et `svg`, `n` doit être égal à `1`.

            - `svg` prend uniquement en charge le texte vers image.

            - Pour un SVG, le modèle d'image génère d'abord une image de
            référence, puis le modèle auteur (`model_params.svg_model`) la
            convertit en graphique vectoriel. Les tokens consommés par ce
            dernier sont facturés séparément selon le modèle choisi.
          enum:
            - png
            - jpeg
            - webp
            - gif
            - svg
          default: png
          example: png
        'n':
          type: integer
          description: >-
            Nombre d'images à générer. Chaque image est facturée séparément.


            **Remarques :**

            - Les tokens d'entrée texte augmentent proportionnellement à `n`.

            - La prise en charge de `n > 1` est actuellement peu fiable : même
            avec une valeur supérieure à 1, une seule image peut être renvoyée.
            Le nombre réel est celui de `results` et la facturation repose sur
            le `usage` renvoyé. Pour obtenir plusieurs images, il est recommandé
            d'envoyer plusieurs requêtes d'une seule image.

            - Avec `output_format=gif` ou `svg`, seule la valeur `1` est
            acceptée.
          minimum: 1
          maximum: 10
          default: 1
          example: 1
        model_params:
          type: object
          description: >-
            Paramètres supplémentaires du modèle. Les paramètres des frames GIF
            et du modèle auteur SVG doivent être placés dans cet objet.


            - `frame_count` et `frame_duration_ms` sont réservés à
            `output_format=gif`.

            - `svg_model` et `svg_reasoning_effort` sont réservés à
            `output_format=svg`.

            - Si les paramètres supplémentaires ne correspondent pas au format
            de sortie, HTTP 400 est renvoyé ; ils ne sont pas ignorés
            silencieusement.
          properties:
            frame_count:
              type: integer
              description: >-
                Nombre de frames du GIF animé. Disponible uniquement avec
                `output_format=gif`, `9` par défaut.


                Toutes les frames sont générées dans une seule image composée.
                La largeur et la hauteur explicites des frames doivent être des
                multiples positifs de `16` ; le minimum de pixels des images
                classiques ne s'applique pas aux frames individuelles. Les
                longueurs des côtés du tableau sont exprimées en pixels.


                | Frames | Limites par frame | Exemple de dimensions |

                |---|---|---|

                | `2`–`8` | ≤ 1 036 800 pixels ; un côté ≤ 960, l'autre ≤ 1920 |
                `960x1072` |

                | `9` | ≤ 921 600 pixels ; les deux côtés ≤ 1280 | `1280x720` |

                | `10`–`12` | ≤ 691 200 pixels ; un côté ≤ 1280, l'autre ≤ 960 |
                `960x720` |

                | `13`–`16` | ≤ 518 400 pixels ; les deux côtés ≤ 960 |
                `720x720` |


                **Dispositions (colonnes × lignes) :**

                - `2`–`8` frames : `4×2` ou `2×4`

                - `9` frames : `3×3`

                - `10`–`12` frames : `3×4` ou `4×3`, puis `4×4` si nécessaire

                - `13`–`16` frames : `4×4`


                **Toutes les conditions suivantes doivent aussi être respectées
                :**

                - Au moins une disposition doit produire une image complète dont
                chaque côté mesure au maximum `3840` px, dont le nombre total de
                pixels ne dépasse pas `8 294 400` et dont le ratio ne dépasse
                pas `3:1`.

                - Avec une disposition `4×4`, chaque frame doit respecter les
                limites de surface et de longueur des côtés indiquées pour
                `13`–`16` frames.

                - Si aucune disposition disponible ne convient, HTTP 400 est
                renvoyé. Les limites de surface et de longueur des côtés du
                tableau ne sont pas les seules contraintes.


                Avec `size=auto`, chaque frame mesure `512×512`, pour tous les
                nombres de frames autorisés. Les tokens de sortie sont calculés
                pour l'image composée entière, et non en additionnant un calcul
                distinct pour chaque frame.
              minimum: 2
              maximum: 16
              default: 9
              example: 9
            frame_duration_ms:
              type: integer
              description: >-
                Durée d’affichage de chaque frame GIF, en millisecondes.
                Disponible uniquement avec `output_format=gif`, `200` par défaut
                ; arrondie par pas de 10 millisecondes.
              minimum: 20
              maximum: 2000
              default: 200
              example: 200
            svg_model:
              type: string
              description: >-
                Modèle auteur SVG, chargé de convertir l'image de référence en
                SVG. Disponible uniquement avec `output_format=svg`,
                `gpt-6.1-terra` par défaut.


                **Remarques :**

                - Les tokens du modèle auteur sont facturés séparément selon le
                modèle choisi.

                - Le `usage` du résultat de la tâche contient `svg_model`,
                `svg_input_tokens` et `svg_output_tokens`.

                - Les tokens d'entrée et de sortie du modèle auteur sont
                détaillés séparément et ne sont pas inclus dans
                `usage.total_tokens`.
              enum:
                - gpt-6.1-terra
                - gpt-6.1-sol
                - gpt-6-astra
                - gpt-6-sol
                - gpt-6-luna
              default: gpt-6.1-terra
              example: gpt-6.1-terra
            svg_reasoning_effort:
              type: string
              description: >-
                Niveau de raisonnement du modèle auteur SVG. Disponible
                uniquement avec `output_format=svg`. Si ce paramètre est omis,
                le niveau par défaut du modèle auteur, `medium`, est utilisé.


                | Modèle auteur | Valeurs acceptées |

                |---|---|

                | `gpt-6.1-terra`, `gpt-6-sol`, `gpt-6-luna` | `none`, `low`,
                `medium`, `high`, `xhigh`, `max` |

                | `gpt-6.1-sol`, `gpt-6-astra` | `low`, `medium`, `high`,
                `xhigh`, `max` |


                **Remarque :**

                - Les tokens de raisonnement sont inclus dans les tokens de
                sortie du modèle auteur.
              enum:
                - none
                - low
                - medium
                - high
                - xhigh
                - max
              example: medium
        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: gpt-image-2.6-sunburst
        object:
          type: string
          enum:
            - image.generation.task
          description: Type spécifique de tâche
        progress:
          type: integer
          description: Pourcentage de progression de la tâche (0-100)
          minimum: 0
          maximum: 100
          example: 1
        status:
          type: string
          description: >-
            État de la tâche. Les tâches en attente et en cours de génération
            sont toutes renvoyées avec `processing` ; l’état final est
            `completed` ou `failed`.
          enum:
            - processing
            - completed
            - failed
          example: processing
        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 de 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 estimé d'achèvement (secondes)
          minimum: 0
          example: 100
    Usage:
      type: object
      description: >-
        Informations sur la réservation provisoire lors de la création de la
        tâche. Consultez l’API de suivi de tâche après son achèvement pour
        connaître la consommation réelle et le détail des tokens.
      properties:
        billing_rule:
          type: string
          description: >-
            Règle de facturation. GPT Image 2.6 est facturé par tranche de 1 000
            tokens. Les tokens image, les tokens d’entrée texte et la
            consommation du modèle auteur SVG sont facturés séparément à leurs
            tarifs respectifs.
          enum:
            - per_1k_tokens
          example: per_1k_tokens
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 2.5
        user_group:
          type: string
          description: Catégorie de groupe d'utilisateurs
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Tous les endpoints nécessitent une authentification par jeton Bearer.


        **Obtenir une API Key :**


        Rendez-vous sur la [page de gestion des API
        Keys](https://evolink.ai/dashboard/keys) pour obtenir votre API Key.


        **Ajoutez cet en-tête aux requêtes :**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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