Nano Banana 2.1

ID:google/nano-banana-2.1

API di generazione immagini Nano Banana 2.1 di Google — il modello di immagini Gemini Flash potenziato per design visivo, editing e coerenza del soggetto, fino al 4K con 14 immagini di riferimento.

Nano Banana 2.1Gemini ImageGoogleEditing immagini4K

Panoramica

API di generazione immagini Nano Banana 2.1 di Google — il modello di immagini Gemini Flash potenziato per design visivo, editing e coerenza del soggetto, fino al 4K con 14 immagini di riferimento.

Autenticazione

Tutte le richieste API richiedono una chiave API valida passata tramite l'header Authorization con lo schema Bearer.

Avvio rapido

Credenziali

Imposta la variabile d'ambiente RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Crea un'esecuzione

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"
    }
  }'

Esecuzioni

Le esecuzioni vengono elaborate in modo asincrono. Invia una richiesta, poi interroga per il risultato.

Crea un'esecuzione

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" }
  }'

Stato dell'esecuzione

Shell

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

Ottieni risultato

Interroga l'endpoint di stato finche status non e "succeeded", poi leggi output.urls dalla risposta.

Schema input

Parametro	Tipo	Obbligatorio	Descrizione
prompt	string	Obbligatorio	Prompt
aspect_ratio	string	Facoltativo	Aspect ratioOpzioni: `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	Facoltativo	ResolutionOpzioni: `1K2K4K`
image_urls	string[]	Facoltativo	Reference images

Schema output

Campo	Tipo	Descrizione
urls	string[]	URL degli output generati

Errori

L'API utilizza codici di stato HTTP standard per indicare successo o errore.

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