Skip to main content
POST
API Nano Banana 2 Lite

Autorisations

Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Corps

application/json
model
enum<string>
défaut:gemini-3.1-flash-lite-image
requis

Nom du modèle de génération d'image, canal officiel, meilleure stabilité et contrôlabilité, adapté aux scénarios commerciaux

Options disponibles:
gemini-3.1-flash-lite-image
Exemple:

"gemini-3.1-flash-lite-image"

prompt
string
requis

Prompt décrivant l’image à générer ou les modifications à apporter à une image d’entrée, limité à 2000 tokens

Maximum string length: 2000
Exemple:

"Un chat jouant dans l’herbe"

size
enum<string>

Rapport d'aspect de l'image générée, par défaut auto

Options disponibles:
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
enum<string>

Qualité de l’image générée, 1K par défaut

Options disponibles:
1K
image_urls
string<uri>[]

Liste des URL d’images de référence pour la génération à partir d’images et la retouche

Remarque :

  • Jusqu’à 14 images d’entrée par requête
  • Taille de l’image : au maximum 20MB
  • Formats pris en charge : .jpeg, .jpg, .png, .webp
  • Les URL doivent être directement accessibles par le serveur ou déclencher un téléchargement direct de l’image (ces URL se terminent généralement par une extension d’image telle que .png ou .jpg)
Exemple:
model_params
object

Paramètres d'extension du modèle

callback_url
string<uri>

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
Exemple:

"https://your-domain.com/webhooks/image-task-completed"

Réponse

Tâche de génération d'image créée avec succès

created
integer

Horodatage de création de la tâche

Exemple:

1757165031

id
string

ID de tâche

Exemple:

"task-unified-1757165031-uyujaw3d"

model
string

Nom du modèle réellement utilisé

Exemple:

"gemini-3.1-flash-lite-image"

object
enum<string>

Type de tâche spécifique

Options disponibles:
image.generation.task
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

task_info
object

Informations sur la tâche asynchrone

type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"image"

usage
object

Informations d'utilisation et de facturation