Nano Banana Pro 画像生成・編集

Google の Nano Banana Pro API (Gemini 3 Pro Image) を使用して、新しい画像を生成または既存の画像を編集します。

使用方法

絶対パスを使用してスクリプトを実行してください（スキルディレクトリに cd しないでください）:

新しい画像を生成:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "画像の説明" --filename "出力名.png" [--resolution 1K|2K|4K] [--api-key キー]

既存の画像を編集:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "編集指示" --filename "出力名.png" --input-image "入力ファイルへのパス.png" [--resolution 1K|2K|4K] [--api-key キー]

重要: ユーザーが作業しているディレクトリから実行してください。画像はスキルディレクトリではなく、ユーザーが作業している場所に保存されます。

解像度オプション

Gemini 3 Pro Image API は 3 つの解像度をサポートしています（大文字の K が必須）:

• 1K (デフォルト) - 約 1024px 解像度
• 2K - 約 2048px 解像度
• 4K - 約 4096px 解像度

ユーザーのリクエストを API パラメータにマップします:

• 解像度についての言及がない → 1K
• 「低解像度」、「1080」、「1080p」、「1K」 → 1K
• 「2K」、「2048」、「通常」、「中程度の解像度」 → 2K
• 「高解像度」、「高 res」、「高 res」、「4K」、「ウルトラ」 → 4K

API キー

スクリプトは以下の順序で API キーを確認します:

1. --api-key 引数（ユーザーがチャットでキーを提供した場合）
2. GEMINI_API_KEY 環境変数

どちらも利用できない場合、スクリプトはエラーメッセージで終了します。

ファイル名生成

ファイル名は yyyy-mm-dd-hh-mm-ss-name.png のパターンで生成します。

形式: {タイムスタンプ}-{説明的名前}.png

• タイムスタンプ: 現在の日時を yyyy-mm-dd-hh-mm-ss 形式で（24 時間形式）
• 名前: ハイフンで区切られた小文字の説明的テキスト
• 説明部分は簡潔に（通常 1～5 語）
• ユーザーのプロンプトまたは会話のコンテキストを使用
• 不明な場合は、ランダムな識別子を使用（例：x9k2、a7b3）

例:

• プロンプト「A serene Japanese garden」→ 2025-11-23-14-23-05-japanese-garden.png
• プロンプト「sunset over mountains」→ 2025-11-23-15-30-12-sunset-mountains.png
• プロンプト「create an image of a robot」→ 2025-11-23-16-45-33-robot.png
• コンテキストが不明 → 2025-11-23-17-12-48-x9k2.png

画像編集

ユーザーが既存の画像を修正したい場合:

1. 画像パスを提供しているか、現在のディレクトリ内の画像を参照しているかを確認します
2. 画像へのパスで --input-image パラメータを使用します
3. プロンプトには編集指示が含まれるべきです（例：「空をより劇的に」、「人物を削除」、「漫画スタイルに変更」）
4. 一般的な編集タスク: 要素の追加・削除、スタイル変更、色調整、背景のぼかし、など

プロンプト処理

生成の場合: ユーザーの画像説明を --prompt にそのまま渡します。明らかに不十分な場合のみ修正します。

編集の場合: --prompt に編集指示を渡します（例：「空に虹を追加」、「水彩画のように見せる」）

両方の場合でユーザーのクリエイティブな意図を保持します。

出力

• PNG を現在のディレクトリに保存します（ファイル名にディレクトリが含まれている場合は指定されたパス）
• スクリプトは生成された画像への完全パスを出力します
• 画像を読み込み直さないでください - 保存されたパスをユーザーに伝えるだけです

例

新しい画像を生成:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "A serene Japanese garden with cherry blossoms" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K

既存の画像を編集:

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "make the sky more dramatic with storm clouds" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K