Nano Banana

ID :google/nano-banana

API de génération d'images Nano Banana par Google — modèle économique propulsé par Gemini 2.5 Flash avec 11 ratios d'aspect et jusqu'à 10 images de référence.

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

Aperçu

API de génération d'images Nano Banana par Google — modèle économique propulsé par Gemini 2.5 Flash avec 11 ratios d'aspect et jusqu'à 10 images de référence.

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",
    "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",
    "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:12:33:23:44:34:55:49:1616:921:9auto`
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	Requête invalide - paramètres manquants ou malformés
401	Échec de l'authentification - clé API manquante ou invalide
402	Crédits insuffisants
403	Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404	Exécution introuvable
429	Limite de requêtes dépassée
500	Erreur interne du serveur