Nano Banana 2 画像生成・編集

Nano Banana 2 (gemini-3.1-flash-image-preview) を使用して新規画像を生成したり、既存の画像を編集したりできます。

使用方法

スキルディレクトリに cd しずに、絶対パスまたはワークスペース相対パスを使用してスクリプトを実行します：

新規画像を生成：

uv run ./.agents/skills/nano-banana-2/scripts/generate_image.py --prompt "画像の説明" --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 "編集指示" --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

一般的なユーザーの言葉をマッピング：

• 「クイックドラフト」「サムネイル」「小さい」「512」「0.5K」 → 512px
• 解像度の指定なし → 1K
• 「2K」「中程度」「標準」 → 2K
• 「4K」「高解像度」「ウルトラ」「印刷品質」 → 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