Nano Banana 2.1

ID :google/nano-banana-2.1

API de génération d'images Nano Banana 2.1 de Google — le modèle d'image Gemini Flash amélioré pour le design visuel, l'édition et la cohérence du sujet, jusqu'en 4K avec 14 images de référence.

Nano Banana 2.1Gemini ImageGoogleÉdition d'image4K

Aperçu

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.1",
    "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.1",
    "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	无效请求 - 参数缺失或格式错误
401	认证失败 - API 密钥缺失或无效
402	额度不足
403	禁止访问 - IP 不在白名单、账号被封禁或 API 密钥消费限额已超出
404	未找到运行记录
429	请求频率超限
500	服务器内部错误