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

# Nanobanana Pro Image Generation

> - Le modèle Nano Banana Pro (gemini-3-pro-image-preview) 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/nanobanana/nanobanana-pro-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Nano Banana Pro Interface
  description: >-
    Créer des tâches de génération d'images en utilisant des modèles IA, prenant
    en charge divers 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: Nano Banana Pro Interface
      description: >-
        - Le modèle Nano Banana Pro (gemini-3-pro-image-preview) 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: createImageGenerationNano2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Texte vers image
                value:
                  model: gemini-3-pro-image-preview
                  prompt: A cat playing on the grass
      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:
                    gemini-3-pro-image-preview
                  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, canal officiel, meilleure
            stabilité et contrôlabilité, adapté aux scénarios commerciaux
          example: gemini-3-pro-image-preview
          enum:
            - gemini-3-pro-image-preview
          default: gemini-3-pro-image-preview
        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 cat playing in the grass
          maxLength: 2000
        size:
          type: string
          description: Rapport d'aspect de l'image générée, par défaut `auto`
          enum:
            - auto
            - '1:1'
            - '2:3'
            - '3:2'
            - '3:4'
            - '4:3'
            - '4:5'
            - '5:4'
            - '9:16'
            - '16:9'
            - '21:9'
        quality:
          type: string
          description: |-
            Qualité de l'image générée, par défaut `2K`

            **Remarque :**
            - La qualité `4K` entraînera des frais supplémentaires
          enum:
            - 1K
            - 2K
            - 4K
        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 `20MB`

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

            - 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`)

            - Maximum de `5` images de personnes réelles peuvent être
            téléchargées
          items:
            type: string
            format: uri
          example:
            - https://example.com/image1.png
            - https://example.com/image2.png
        model_params:
          type: object
          description: Paramètres d'extension du modèle
          properties:
            web_search:
              type: boolean
              description: >-
                Activer ou non la recherche web. Lorsqu'activé, le modèle
                utilise les résultats de recherche web pour optimiser la
                génération d'images
              example: true
        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-uyujaw3d
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: gemini-3-pro-image-preview
        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_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Crédits estimés consommés
          minimum: 0
          example: 1.6
        user_group:
          type: string
          description: Catégorie de groupe d'utilisateurs
          enum:
            - default
            - vip
          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

        ```

````