Nano Banana

Gemini-native Nano Banana 画像生成と編集のための単一の Python エントリーポイント。モデルエイリアス、厳密なオプション検証、バッチ実行、カスタムエンドポイント対応を備えています。

ワークフロー

1. references/config.md を開いて環境変数とオーバーライド順序を選択します。
2. references/models-and-api.md を開いて適切な Nano Banana ティアを選択し、モデル固有の制約を確認します。
3. 最速で低コストのデフォルト (nanobanana) または最高忠度の推論モデル (nanobanana-pro) が必要な場合を除き、gemini-3.1-flash-image-preview (nanobanana-2) を優先します。
4. 単一リクエストの場合は 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 は /models/... に直接ではなく、https://generativelanguage.googleapis.com/v1beta のような Gemini API ルートを指す必要があります。
• --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