> ## 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 2 Lite Image Generation

> - Le modele Nano Banana 2 Lite (gemini-3.1-flash-lite-image) prend en charge les modes texte-vers-image, image-vers-image, edition d'image et autres modes de generation
- Mode de traitement asynchrone, utilisez l'ID de tache retourne pour [interroger](/fr/api-manual/task-management/get-task-detail)
- Les liens d'image generes sont valides pendant 24 heures, veuillez les enregistrer rapidement



## OpenAPI

````yaml fr/api-manual/image-series/nanobanana/nanobanana-2-lite-image-generate.json POST /v1/images/generations
openapi: 3.1.0
info:
  title: Nano Banana 2 Lite Interface
  description: >-
    Creer des taches de generation d'images en utilisant des modeles IA, prenant
    en charge divers modeles et configurations de parametres
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.evolink.ai
    description: Environnement de production
security:
  - bearerAuth: []
tags:
  - name: Generation d'image
    description: APIs liees a la generation d'images IA
paths:
  /v1/images/generations:
    post:
      tags:
        - Generation d'image
      summary: Nano Banana 2 Lite Interface
      description: >-
        - Le modele Nano Banana 2 Lite (gemini-3.1-flash-lite-image) prend en
        charge les modes texte-vers-image, image-vers-image, edition d'image et
        autres modes de generation

        - Mode de traitement asynchrone, utilisez l'ID de tache retourne pour
        [interroger](/fr/api-manual/task-management/get-task-detail)

        - Les liens d'image generes sont valides pendant 24 heures, veuillez les
        enregistrer rapidement
      operationId: createImageGenerationNanoBanana2Lite
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImageGenerationRequest'
            examples:
              text_to_image:
                summary: Texte vers image
                value:
                  model: gemini-3.1-flash-lite-image
                  prompt: A cat playing on the grass
      responses:
        '200':
          description: Tache de generation d'image creee avec succes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImageGenerationResponse'
        '400':
          description: Parametres de requete 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 authentifie, jeton invalide ou expire
          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: Acces refuse
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: model_access_denied
                  message: >-
                    Token does not have access to model:
                    gemini-3.1-flash-lite-image
                  type: invalid_request_error
        '429':
          description: Limite de debit depassee
          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 modele de generation d'image, canal officiel, meilleure
            stabilite et controlabilite, adapte aux scenarios commerciaux
          example: gemini-3.1-flash-lite-image
          enum:
            - gemini-3.1-flash-lite-image
          default: gemini-3.1-flash-lite-image
        prompt:
          type: string
          description: >-
            Invite decrivant l'image a generer, ou decrivant comment editer
            l'image d'entree, limitee a 2000 tokens
          example: A cat playing in the grass
          maxLength: 2000
        size:
          type: string
          description: Rapport d'aspect de l'image generee, par defaut `auto`
          enum:
            - auto
            - '1:1'
            - '1:4'
            - '4:1'
            - '1:8'
            - '8:1'
            - '2:3'
            - '3:2'
            - '3:4'
            - '4:3'
            - '4:5'
            - '5:4'
            - '9:16'
            - '16:9'
            - '21:9'
        quality:
          type: string
          description: Qualite de l'image generee, par defaut `1K`
          enum:
            - 1K
        image_urls:
          type: array
          description: >-
            Liste d'URL d'images de reference pour les fonctions image vers
            image et edition d'image


            **Remarque :**

            - Nombre maximum d'images d'entree par requete : `14`

            - Taille d'image : ne depassant pas `20MB`

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

            - Les URL d'images doivent etre directement accessibles par le
            serveur, ou l'URL de l'image doit declencher un telechargement
            direct lors de l'acces (generalement ces URL 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
        model_params:
          type: object
          description: Parametres d'extension du modele
          properties:
            thinking_level:
              type: string
              description: >-
                Niveau de reflexion, controle la profondeur de raisonnement du
                modele avant la generation d'images, par defaut `auto`


                - `auto` : Selection automatique du niveau de reflexion

                - `min` : Raisonnement minimal, le plus rapide

                - `high` : Raisonnement approfondi, meilleure qualite
              enum:
                - auto
                - min
                - high
              example: auto
        callback_url:
          type: string
          description: >-
            Adresse de rappel HTTPS apres l'achevement de la tache


            **Moment du rappel :**

            - Declenche lorsque la tache est terminee, echouee ou annulee

            - Envoye apres confirmation de la facturation


            **Restrictions de securite :**

            - 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 depasser `2048` caracteres


            **Mecanisme de rappel :**

            - Delai d'expiration : `10` secondes

            - Maximum `3` tentatives en cas d'echec (tentatives apres `1`
            seconde/`2` secondes/`4` secondes)

            - Le format du corps de reponse du rappel est coherent avec le
            format de reponse de l'API de requete de tache

            - Un code de statut 2xx renvoye par l'adresse de rappel est
            considere comme un succes, les autres codes de statut declenchent
            une nouvelle tentative
          format: uri
          example: https://your-domain.com/webhooks/image-task-completed
    ImageGenerationResponse:
      type: object
      properties:
        created:
          type: integer
          description: Horodatage de creation de la tache
          example: 1757165031
        id:
          type: string
          description: ID de tache
          example: task-unified-1757165031-uyujaw3d
        model:
          type: string
          description: Nom du modele reellement utilise
          example: gemini-3.1-flash-lite-image
        object:
          type: string
          enum:
            - image.generation.task
          description: Type de tache specifique
        progress:
          type: integer
          description: Pourcentage de progression de la tache (0-100)
          minimum: 0
          maximum: 100
          example: 0
        status:
          type: string
          description: Statut de la tache
          enum:
            - pending
            - processing
            - completed
            - failed
          example: pending
        task_info:
          $ref: '#/components/schemas/TaskInfo'
          description: Informations sur la tache asynchrone
        type:
          type: string
          enum:
            - text
            - image
            - audio
            - video
          description: Type de sortie de la tache
          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 tache peut etre annulee
          example: true
        estimated_time:
          type: integer
          description: Temps d'achevement estime (secondes)
          minimum: 0
          example: 45
    Usage:
      type: object
      description: Informations d'utilisation et de facturation
      properties:
        billing_rule:
          type: string
          description: Regle de facturation
          enum:
            - per_call
            - per_token
            - per_second
          example: per_call
        credits_reserved:
          type: number
          description: Credits estimes consommes
          minimum: 0
          example: 8.7
        user_group:
          type: string
          description: Categorie de groupe d'utilisateurs
          enum:
            - default
            - vip
          example: default
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Toutes les API necessitent une authentification Bearer Token##


        **Obtenir une cle API :**


        Visitez la [Page de gestion des cles
        API](https://evolink.ai/dashboard/keys) pour obtenir votre cle API


        **Ajouter a l'en-tete de requete :**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````