Nano Banana 2 画像生成・編集
Google の Nano Banana 2 API(Gemini 3.1 Flash Image)を使用して、新しい画像を生成したり、既存の画像を編集します。
使用方法
スクリプトは絶対パスで実行してください(最初に skill ディレクトリに cd しないこと)。
新しい画像を生成:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "画像の説明" --filename "出力ファイル名.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
既存の画像を編集:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "編集指示" --filename "出力ファイル名.png" --input-image "入力画像のパス.png" [--resolution 512|1K|2K|4K] [--api-key KEY]
重要: 常にユーザーの現在の作業ディレクトリから実行し、画像が skill ディレクトリではなくユーザーの作業場所に保存されるようにしてください。
デフォルトのワークフロー(ドラフト → イテレーション → 最終)
目標:プロンプトが確定するまでは 4K で時間を浪費せず、高速に反復すること。
- ドラフト(1K):素早いフィードバックループ
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<ドラフトプロンプト>" --filename "yyyy-mm-dd-hh-mm-ss-draft.png" --resolution 1K
- イテレーション:プロンプトを少しずつ調整。実行ごとに新しいファイル名を付ける。
- 編集の場合:満足するまで毎回同じ
--input-imageを使用する。
- 編集の場合:満足するまで毎回同じ
- 最終(4K):プロンプトが確定したら
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "<最終プロンプト>" --filename "yyyy-mm-dd-hh-mm-ss-final.png" --resolution 4K
解像度オプション
Gemini 3.1 Flash Image API は以下の出力サイズ値をサポートしています。
- 512 - コンパクトな ~512px クラスの解像度
- 1K(デフォルト)- ~1024px 解像度
- 2K - ~2048px 解像度
- 4K - ~4096px 解像度
ユーザーの要求を API パラメータにマッピング:
- "512", "512px", "0.5K", "thumbnail", "tiny" →
512 - 解像度の指定がない場合 →
1K - "low resolution", "1080", "1080p", "1K" →
1K - "2K", "2048", "normal", "medium resolution" →
2K - "high resolution", "high-res", "hi-res", "4K", "ultra" →
4K
API キー
スクリプトは以下の順序で API キーを確認します。
--api-key引数(ユーザーがチャットでキーを提供した場合に使用)GEMINI_API_KEY環境変数
どちらも利用できない場合、スクリプトはエラーメッセージを表示して終了します。
事前確認 + よくある失敗(素早い修正)
-
事前確認:
command -v uv(存在する必要あり)test -n "$GEMINI_API_KEY"(または--api-keyを渡す)- 編集の場合:
test -f "path/to/input.png"
-
よくある失敗:
Error: No API key provided.→GEMINI_API_KEYを設定するか--api-keyを渡すError loading input image:→ パスが間違っているかファイルが読み取れない;--input-imageが実際の画像を指しているか確認- 「quota/permission/403」系の API エラー → キーが間違っている、アクセス権がない、またはクォータ超過;別のキーやアカウントを試す
ファイル名生成
ファイル名は 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
画像編集
ユーザーが既存の画像を変更したい場合:
- 画像パスが提供されているか、またはカレントディレクトリ内の画像が参照されているかを確認
--input-imageパラメータに画像のパスを指定- プロンプトには編集指示を含める(例:「空をもっとドラマチックに」、「人物を消して」、「漫画スタイルに変更して」)
- 一般的な編集タスク:要素の追加・削除、スタイル変更、色調整、背景ぼかしなど
プロンプトの扱い
生成の場合: ユーザーの画像説明をそのまま --prompt に渡します。明らかに不十分な場合のみ修正します。
編集の場合: 編集指示を --prompt に渡します(例:「空に虹を追加」、「水彩画のように見せる」)
どちらの場合もユーザーの創造意図を尊重してください。
プロンプトテンプレート(成功率が高いもの)
ユーザーが曖昧な場合や、編集を正確に行う必要がある場合にテンプレートを使用します。
-
生成テンプレート:
- 「<主題> の画像を作成。スタイル:<スタイル>。構図:<カメラ/ショット>。照明:<照明>。背景:<背景>。カラーパレット:<パレット>。避けるもの:<リスト>。」
-
編集テンプレート(それ以外は維持):
- 「変更するのは <1つの変更> のみ。維持するもの:主題、構図/トリミング、ポーズ、照明、カラーパレット、背景、テキスト、および全体的なスタイル。新しいオブジェクトを追加しない。テキストがある場合は変更しない。」
出力
- PNG をカレントディレクトリに保存(ファイル名にディレクトリを含めることでパス指定可能)
- スクリプトは生成された画像のフルパスを出力
- 画像を読み込んで表示しない – 保存されたパスをユーザーに知らせるだけ
例
新しい画像を生成:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "桜のある静かな日本庭園" --filename "2025-11-23-14-23-05-japanese-garden.png" --resolution 4K
既存の画像を編集:
uv run ~/.codex/skills/nano-banana-pro/scripts/generate_image.py --prompt "空を嵐雲でもっとドラマチックに" --filename "2025-11-23-14-25-30-dramatic-sky.png" --input-image "original-photo.jpg" --resolution 2K