mcpField
N
nano-banana-pro

nano-banana-pro

github.com/intellectronicaクリエイティブ・メディア2983.2k 回インストール27 週間前に更新
リポジトリ

nano-banana-pro について

nano-banana-proは、Google's Nano Banana Pro API（Gemini 3 Pro Image）で画像を生成・編集するスキルです。出力解像度は1K、2K、4Kから選べます。

主な機能

  1. 01プロンプトから画像を生成
  2. 02指示に沿った画像編集
  3. 031K、2K、4K解像度の選択
  4. 04PNGを作業ディレクトリに保存

活用シーン

  1. 01説明文から画像を作成
  2. 02画像内の要素やスタイルを変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/intellectronica/agent-skills --skill nano-banana-pro

インストール後、Claude Code で/nano-banana-proを入力して読み込まれたか確認します。

同梱ファイルscripts/generate_image.py

詳細

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 "your image description" --filename "output-name.png" [--resolution 1K|2K|4K] [--api-key KEY]

既存の画像を編集：

uv run ~/.claude/skills/nano-banana-pro/scripts/generate_image.py --prompt "editing instructions" --filename "output-name.png" --input-image "path/to/input.png" [--resolution 1K|2K|4K] [--api-key KEY]

重要： 画像はスキルのディレクトリではなく、ユーザーが作業している場所に保存されるよう、必ずユーザーの現在の作業ディレクトリから実行してください。

解像度の選択肢

Gemini 3 Pro Image API は 3 種類の解像度をサポートしています（K は大文字で指定する必要があります）。

  • 1K（デフォルト） - 約 1024 ピクセルの解像度
  • 2K - 約 2048 ピクセルの解像度
  • 4K - 約 4096 ピクセルの解像度

ユーザーのリクエストを API パラメーターに対応させます。

  • 解像度の指定なし → 1K
  • 「低解像度」、「1080」、「1080p」、「1K」 → 1K
  • 「2K」、「2048」、「通常」、「中解像度」 → 2K
  • 「高解像度」、「高精細」、「ハイレゾ」、「4K」、「ウルトラ」 → 4K

API キー

スクリプトは次の順序で API キーを確認します。

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

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

ファイル名の生成

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

形式： {timestamp}-{descriptive-name}.png

  • タイムスタンプ：現在の日付と時刻を yyyy-mm-dd-hh-mm-ss 形式で指定（24 時間形式）
  • 名前：ハイフンで区切った、内容を表す小文字のテキスト
  • 説明部分は簡潔にします（通常 1～5 語）
  • ユーザーのプロンプトや会話の文脈を使用します
  • 文脈が不明確な場合は、ランダムな識別子を使用します（例：x9k2、a7b3）

例：

  • プロンプト「穏やかな日本庭園」 → 2025-11-23-14-23-05-japanese-garden.png
  • プロンプト「山に沈む夕日」 → 2025-11-23-15-30-12-sunset-mountains.png
  • プロンプト「ロボットの画像を作成」 → 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

コメント

Markdown 対応