Passer au contenu principal
POST
/
v1
/
images
/
generations
Nano Banana 2 Lite Interface
curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gemini-3.1-flash-lite-image",
  "prompt": "A cat playing on the grass"
}
'
{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "gemini-3.1-flash-lite-image",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 8.7,
    "user_group": "default"
  }
}

Autorisations

​
Authorization
string
header
requis

##Toutes les API necessitent une authentification Bearer Token##

Obtenir une cle API :

Visitez la Page de gestion des cles API pour obtenir votre cle API

Ajouter a l'en-tete de requete :

Authorization: Bearer YOUR_API_KEY

Corps

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

Nom du modele de generation d'image, canal officiel, meilleure stabilite et controlabilite, adapte aux scenarios commerciaux

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

"gemini-3.1-flash-lite-image"

​
prompt
string
requis

Invite decrivant l'image a generer, ou decrivant comment editer l'image d'entree, limitee a 2000 tokens

Maximum string length: 2000
Exemple:

"A cat playing in the grass"

​
size
enum<string>

Rapport d'aspect de l'image generee, par defaut 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>

Qualite de l'image generee, par defaut 1K

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

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)
Exemple:
[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
​
model_params
object

Parametres d'extension du modele

​
callback_url
string<uri>

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

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

Réponse

Tache de generation d'image creee avec succes

​
created
integer

Horodatage de creation de la tache

Exemple:

1757165031

​
id
string

ID de tache

Exemple:

"task-unified-1757165031-uyujaw3d"

​
model
string

Nom du modele reellement utilise

Exemple:

"gemini-3.1-flash-lite-image"

​
object
enum<string>

Type de tache specifique

Options disponibles:
image.generation.task
​
progress
integer

Pourcentage de progression de la tache (0-100)

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

0

​
status
enum<string>

Statut de la tache

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

"pending"

​
task_info
object

Informations sur la tache asynchrone

​
type
enum<string>

Type de sortie de la tache

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

"image"

​
usage
object

Informations d'utilisation et de facturation