nano-banana-2

Nano Banana 2 による画像生成と編集

Nano Banana 2（gemini-3.1-flash-image-preview）を使って、新しい画像を生成したり、既存の画像を編集したりできます。

使い方

絶対パスまたはワークスペース相対パスを使ってスクリプトを実行します（最初にスキルディレクトリへ移動しないでください）。

新しい画像を生成する場合：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "your image description" --filename "output-name.png" [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]

参照画像を使って画像を編集する場合：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input1.png" [--input-image "path/to/input2.png" ...] [--resolution 512px|1K|2K|4K] [--aspect-ratio RATIO] [--api-key KEY]

出力が現在のプロジェクトのコンテキストに保存されるよう、必ずユーザーの現在の作業ディレクトリから実行してください。

モデル

次のモデルコードを使用します。

• gemini-3.1-flash-image-preview（Nano Banana 2）

このスキルでは gemini-3-pro-image-preview を使用しないでください。

解像度のオプション

Nano Banana 2 では、次の解像度をサポートしています。

• 512px（最速、低レイテンシでの反復に適しています）
• 1K（デフォルト）
• 2K
• 4K

ユーザーがよく使う表現は、次のように対応付けます。

• 「quick draft」「thumbnail」「tiny」「512」「0.5K」→ 512px
• 解像度の指定なし → 1K
• 「2K」「medium」「normal」→ 2K
• 「4K」「high-res」「ultra」「print quality」→ 4K

1K、2K、4K では、大文字の K を使用します。

アスペクト比

次のアスペクト比をサポートしています。

• 1:1、1:4、1:8、2:3、3:2、3:4、4:1、4:3、4:5、5:4、8:1、9:16、16:9、21:9

よくあるリクエストは、次のように対応付けます。

• 正方形の投稿／アイコン → 1:1
• スマートフォンの壁紙／縦型リール → 9:16
• ワイドスクリーン／スライド／ヒーロー画像 → 16:9
• シネマティックなワイド画像 → 21:9
• ポートレート印刷 → 2:3 または 3:4
• パノラマバナー → 4:1 または 8:1

指定がない場合は、モデルのデフォルトの動作に任せます。

参照画像（Gemini 3 の画像ワークフローで新たに追加）

必要に応じて --input-image を繰り返し指定し、最大14枚の参照画像を渡せます。

• キャラクターの一貫性を保つ
• オブジェクトの忠実度を保つ
• 複数の視覚的な参照を1つの出力にまとめる

簡単な編集には1枚の画像を、構図や一貫性が重要なタスクには複数の画像を使用します。

API キー

次の順序で API キーを解決します。

1. --api-key 引数
2. GEMINI_API_KEY 環境変数

キーが利用できない場合は処理を停止し、明確なエラーを報告します。

ファイル名の生成

ファイル名は yyyy-mm-dd-hh-mm-ss-name.png の形式で生成します。

例：

• 2026-02-26-17-31-04-japanese-garden.png
• 2026-02-26-17-31-59-social-banner.png

プロンプトの処理

生成では、ユーザーのリクエストが大幅に不明確でない限り、そのまま渡します。 編集では、プロンプトに明示的な変換指示を含め、元の意図を維持します。

出力

• PNG を現在のディレクトリ（または --filename で指定されたパス）に保存します
• 保存したパスをすべて返します
• 明示的に依頼された場合を除き、出力画像を読み戻さないでください

例

4K のワイドスクリーン画像を作成する：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Futuristic city skyline at blue hour with neon reflections" --filename "2026-02-26-17-45-00-futuristic-skyline.png" --resolution 4K --aspect-ratio 16:9

複数の参照画像を使って編集する：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "Create a polished campaign image that keeps the exact logo details and character identity" --filename "2026-02-26-17-50-10-campaign-image.png" --input-image "logo.png" --input-image "character.png" --resolution 2K --aspect-ratio 4:5