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	Richiesta non valida - parametri mancanti o malformati
401	Autenticazione fallita - chiave API mancante o non valida
402	Crediti insufficienti
403	Accesso negato - IP non consentito o limite di spesa della chiave API superato
404	Esecuzione non trovata
429	Limite di frequenza superato
500	Errore interno del server