nanobanana

Nano Banana

Gemini ネイティブの Nano Banana による画像生成・編集のための、単一の Python エントリーポイントです。モデルエイリアス、厳密なオプション検証、バッチ実行、カスタムエンドポイントに対応しています。

ワークフロー

1. 環境変数と上書きの優先順位を選ぶには、references/config.md を開きます。
2. 適切な Nano Banana のティアを選び、モデル固有の制約を確認するには、references/models-and-api.md を開きます。
3. 最速で低コストなデフォルトモデル（nanobanana）か、最高忠実度の推論モデル（nanobanana-pro）が必要でない限り、gemini-3.1-flash-image-preview（nanobanana-2）を優先してください。
4. 1 件のリクエストには scripts/nanobanana.py generate を、バリエーションを繰り返し生成するには scripts/nanobanana.py batch を実行します。
5. 主なリスクがペイロードの形式、エンドポイント、またはモデル固有のオプションのサポート状況にある場合は、まず --dry-run を追加します。
6. カスタムの Gemini 互換ゲートウェイが必要な場合は、--base-url または GEMINI_BASE_URL を渡します。
7. デバッグ用に未加工の JSON ボディが必要な場合は、generate に --save-response <path> を追加します。

コマンド

テキストから画像への単一リクエスト：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "A retro-futurist product hero illustration for a developer tool" `
  --output .\out\hero.png `
  --model nanobanana-2 `
  --ratio 16:9 `
  --size 2K

2 つのローカル参照画像を使って既存の画像を編集する：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "Turn these references into a clean launch poster with legible title text" `
  --input-image .\refs\subject.png `
  --input-image .\refs\background.png `
  --output .\out\poster.png `
  --model nanobanana-pro `
  --ratio 4:5 `
  --size 2K

カスタムの Gemini 互換ゲートウェイを使用する：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "A bold mascot sticker pack" `
  --output .\out\stickers.png `
  --base-url http://your-gateway.example.com/v1beta `
  --auth-mode bearer

5 種類のバリエーションをバッチ生成する：

python .\skills\nanobanana\scripts\nanobanana.py batch `
  --prompt "Minimal app icon for a PDF workflow product" `
  --count 5 `
  --dir .\out\icons `
  --prefix icon `
  --model nanobanana `
  --ratio 1:1

送信せずに最終リクエストを確認する：

python .\skills\nanobanana\scripts\nanobanana.py generate `
  --prompt "An editorial illustration of AI agents at work" `
  --model nanobanana-2 `
  --output .\out\agents.png `
  --dry-run

ルール

• --model は、エイリアスの nanobanana、nanobanana-2、nanobanana-pro、または正確な Gemini モデル ID を受け付けます。
• nanobanana は gemini-2.5-flash-image に、nanobanana-2 は gemini-3.1-flash-image-preview に、nanobanana-pro は gemini-3-pro-image-preview に解決されます。
• image_size は Gemini 3 の画像モデルでのみ有効です。nanobanana では --size は使用できません。
• 512 の解像度は nanobanana-2 でのみ有効です。
• プロセス環境変数は .env を上書きし、CLI フラグはその両方を上書きします。
• シークレットを出力しないでください。
• generate では、画像編集または複数の参照画像を使った生成のために、--input-image のパスを繰り返し指定できます。
• --base-url には、https://generativelanguage.googleapis.com/v1beta のような Gemini API のルートを指定してください。/models/... を直接指定しないでください。
• --auth-mode auto は、Google の公式エンドポイントでは x-goog-api-key を使用します。カスタムエンドポイントでは、ゲートウェイとの互換性を高めるため、Authorization: Bearer と x-goog-api-key の両方を送信します。

リソース

• スクリプト：scripts/nanobanana.py
• 設定リファレンス：references/config.md
• モデルと API のリファレンス：references/models-and-api.md