Nano Banana 2.1

ID:google/nano-banana-2.1

Google の Nano Banana 2.1 画像生成 API — Gemini Flash の画像モデルをビジュアルデザイン、編集、被写体の一貫性で強化。最大 4K、参照画像は 14 枚まで。

Nano Banana 2.1Gemini ImageGoogle画像編集4K

概要

Google の Nano Banana 2.1 画像生成 API — Gemini Flash の画像モデルをビジュアルデザイン、編集、被写体の一貫性で強化。最大 4K、参照画像は 14 枚まで。

認証

すべての 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.1",
    "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.1",
    "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	잘못된 요청 - 매개변수가 누락되었거나 형식이 올바르지 않습니다
401	인증 실패 - API 키가 누락되었거나 유효하지 않습니다
402	크레딧 부족
403	접근 거부 - IP가 허용되지 않았거나, 계정이 차단되었거나, API 키 지출 한도 초과
404	실행을 찾을 수 없습니다
429	요청 속도 제한 초과
500	내부 서버 오류