Nano Banana 2

ID :google/nano-banana-2

API de génération d'images Nano Banana 2 par Google — Gemini 3.1 Flash avec sortie 4K, 15 ratios d'aspect et cohérence de personnage pour jusqu'à 5 personnages.

Text to imageÉdition d'imageImages de référence4KRendu de texte

Aperçu

API de génération d'images Nano Banana 2 par Google — Gemini 3.1 Flash avec sortie 4K, 15 ratios d'aspect et cohérence de personnage pour jusqu'à 5 personnages.

Authentification

Toutes les requêtes API nécessitent une clé API valide transmise via l'en-tête Authorization avec le schéma Bearer.

Démarrage rapide

Identifiants

Définissez la variable d'environnement RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Créer une exécution

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Exécutions

Les exécutions sont traitées de manière asynchrone. Soumettez une requête, puis interrogez le résultat.

Créer une exécution

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-2",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Obtenir le statut d'exécution

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Obtenir le résultat

Interrogez l'endpoint de statut jusqu'à ce que status soit "succeeded", puis lisez output.urls dans la réponse.

Schéma d'entrée

Paramètre	Type	Requis	Description
prompt	string	Requis	Prompt
aspect_ratio	string	Optionnel	Aspect ratioOptions : `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Optionnel	ResolutionOptions : `1K2K4K`
image_urls	string[]	Optionnel	Reference images

Schéma de sortie

Champ	Type	Description
urls	string[]	URLs des résultats générés

Erreurs

L'API utilise les codes de statut HTTP standard pour indiquer le succès ou l'échec.

Code de statut	Description
400	Request không hợp lệ - thiếu hoặc sai định dạng tham số
401	Xác thực thất bại - thiếu hoặc sai khóa API
402	Không đủ tín dụng
403	Bị từ chối - IP không được phép hoặc khóa API vượt giới hạn chi tiêu
404	Không tìm thấy lượt chạy
429	Vượt giới hạn tốc độ
500	Lỗi máy chủ nội bộ