Nano Banana 2

ID：google/nano-banana-2

Google 的 Nano Banana 2 圖片產生 API — 基於 Gemini 3.1 Flash，4K 輸出、15 種比例、最多 5 個角色一致性。

文字轉圖片圖片編輯參考圖片4K文字渲染

概覽

Google 的 Nano Banana 2 圖片產生 API — 基於 Gemini 3.1 Flash，4K 輸出、15 種比例、最多 5 個角色一致性。

驗證

所有 API 請求都需要透過 Authorization 標頭以 Bearer 方式傳遞有效的 API 金鑰。

快速開始

憑證

設定 RUNBASE_API_KEY 環境變數。

Shell

export RUNBASE_API_KEY=your-api-key

建立執行

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

執行紀錄

執行為非同步處理。提交請求後，輪詢取得結果。

建立執行

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

取得執行狀態

Shell

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

取得結果

輪詢狀態端點，直到 status 為 "succeeded"，然後從回應中讀取 output.urls。

輸入結構

參數	類型	必填	說明
prompt	string	必填	Prompt
aspect_ratio	string	選填	Aspect ratio選項： `1:11:41:82:33:23:44:14:34:55:48:19:1616:921:9auto`
resolution	string	選填	Resolution選項： `1K2K4K`
image_urls	string[]	選填	Reference images

輸出結構

欄位	類型	說明
urls	string[]	產生的輸出 URL

錯誤

API 使用標準 HTTP 狀態碼表示成功或失敗。

狀態碼	說明
400	Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401	Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402	Unzureichendes Guthaben
403	Zugriff verweigert – IP nicht erlaubt oder Ausgabenlimit des API-Schlüssels überschritten
404	Ausführung nicht gefunden
429	Rate-Limit überschritten
500	Interner Serverfehler