nanobanana

Nano Banana - AI 画像生成スキル

scripts/ の Python スクリプトを使って、Google Gemini 経由で画像を生成・編集します。 モデルはプロンプトの複雑さに基づいて自動的に選択されます。

モデル	ID	使用されるケース
Nano Banana Pro	gemini-3-pro-image-preview	複雑なリクエストや高品質なリクエスト
Nano Banana 2	gemini-3.1-flash-image-preview	シンプルで軽量なリクエスト

以下の条件のいずれか（OR）を満たす場合、Nano Banana Pro が自動選択されます。

• --pro フラグが指定されている
• プロンプトに品質を示すキーワード（例：高品質、高精細、プロ、professional、photorealistic）が含まれている
• プロンプトが100文字以上である
• 入力画像が2枚以上ある
• 4K 解像度が指定されている
• Google Search grounding が有効になっている

前提条件

1. 依存関係をインストールする

pip install google-genai Pillow

2. API 認証情報を設定する（以下のいずれか）

オプション A：Gemini Developer API（個人利用におすすめ）

GEMINI_API_KEY 環境変数を設定します。 https://aistudio.google.com/apikey でキーを取得してください。

export GEMINI_API_KEY="your-api-key"

オプション B：Vertex AI API（Google Cloud ユーザー向け）

GOOGLE_CLOUD_PROJECT と、必要に応じて GOOGLE_CLOUD_LOCATION を設定します。 Vertex AI API が有効になっている GCP プロジェクトと、 Application Default Credentials の設定（gcloud auth application-default login）が必要です。

export GOOGLE_CLOUD_PROJECT="your-project-id"
export GOOGLE_CLOUD_LOCATION="us-central1"   # optional, defaults to us-central1

優先順位： GOOGLE_CLOUD_PROJECT と GEMINI_API_KEY の両方が設定されている場合は、 Vertex AI が使用されます。

3. 任意の環境変数

変数	デフォルト	説明
NANOBANANA_MODEL	(auto)	特定のモデルを固定します（自動選択を上書き）
IMAGE_OUTPUT_DIR	./nanobanana-images	デフォルトの出力ディレクトリ
NANOBANANA_NO_SSL_VERIFY	(unset)	SSL 証明書の検証を無効にするには、1／true／yes を設定します

---

スクリプト

scripts/generate.py - 画像の生成／編集（1枚）

テキストから画像を生成

python scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png

画像編集（参照画像を使用）

python scripts/generate.py "make the sky purple and add stars" -i photo.jpg -o edited.png

複数の参照画像（最大14枚）

python scripts/generate.py "group photo of these people at a party" \
  -i person1.png -i person2.png -i person3.png -o group.png

アスペクト比と解像度を指定

python scripts/generate.py "cinematic landscape, dramatic lighting" \
  --ratio 21:9 --size 4K -o landscape.png

Google Search grounding を使用（実世界の情報の正確性を高める）

python scripts/generate.py "photo of the Eiffel Tower at sunset" \
  --search -o eiffel.png

SSL 検証を無効にする（企業のプロキシや自己署名証明書向け）

python scripts/generate.py "abstract art" --no-ssl-verify -o art.png

JSON 出力（プログラムからの利用向け）

python scripts/generate.py "abstract art" --json -o art.png

すべてのオプション

usage: generate.py [-h] [-o OUTPUT] [-i INPUTS] [-r RATIO] [-s SIZE]
                   [--search] [-v] [--json] [--no-ssl-verify] prompt

Arguments:
  prompt              Text prompt for image generation

Options:
  -o, --output PATH   Output file path (auto-generated if omitted)
  -i, --input PATH    Input image for editing (repeatable, up to 14)
  -r, --ratio RATIO   Aspect ratio: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
  -s, --size SIZE     Resolution: 1K, 2K, 4K
  --search            Enable Google Search grounding
  --pro               Force Nano Banana Pro model
  -v, --verbose       Show detailed output
  --json              Output result as JSON
  --no-ssl-verify     Disable SSL certificate verification

---

scripts/batch_generate.py - 画像の一括生成

1つのプロンプトから、複数の画像バリエーションを生成します。

基本的な一括生成

python scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo

アスペクト比を指定した高解像度の一括生成

python scripts/batch_generate.py "product photo, white background" \
  -n 10 --ratio 1:1 --size 4K -d ./products

並列実行（高速化）

python scripts/batch_generate.py "icon set" -n 20 --parallel 5 -d ./icons

すべてのオプション

usage: batch_generate.py [-h] [-n COUNT] [-d DIR] [-p PREFIX] [-r RATIO]
                         [-s SIZE] [--search] [--delay DELAY]
                         [--parallel N] [-q] [--json] [--no-ssl-verify] prompt

Arguments:
  prompt              Text prompt for image generation

Options:
  -n, --count N       Number of images (default: 10)
  -d, --dir DIR       Output directory (default: ./nanobanana-images)
  -p, --prefix STR    Filename prefix (default: image)
  -r, --ratio RATIO   Aspect ratio
  -s, --size SIZE     Resolution: 1K, 2K, 4K
  --search            Enable Google Search grounding
  --delay SECS        Delay between sequential requests (default: 3)
  --parallel N        Concurrent requests (default: 1, max recommended: 5)
  -q, --quiet         Suppress progress output
  --json              Output results as JSON
  --no-ssl-verify     Disable SSL certificate verification

---

アスペクト比ガイド

比率	一般的な用途
1:1	アイコン、アバター、ソーシャルメディアの投稿
4:3	プレゼンテーション、従来型の写真
3:2	標準的な横向き写真
2:3	縦向き写真
16:9	バナー、YouTube のサムネイル、ワイドスクリーン
9:16	スマートフォンの壁紙、Instagram ストーリーズ
21:9	シネマティックな超ワイド
4:5	Instagram の縦向き投稿
5:4	集合写真
3:4	本の表紙、縦向きのアート

解像度ガイド

サイズ	説明
1K	標準解像度
2K	高解像度
4K	超高解像度（印刷や大型ディスプレイに最適）

---

プロンプトのヒント

効果的なプロンプトには、次の要素が含まれます。

1. 被写体 - 生成するもの（「ロボット」「山に沈む夕日」など）
2. スタイル - アートのスタイル（「ピクセルアート」「水彩画」「フォトリアリスティック」など）
3. 詳細 - 具体的な特徴（「暖かみのある照明」「ミニマリスト」「鮮やかな色」など）

効果的なプロンプトの例：

• "Professional product photo of wireless headphones on marble, soft studio lighting, 85mm lens"
• "Pixel art robot mascot, 8-bit style, blue and orange, transparent background"
• "Minimalist logo, geometric mountain shape, blue gradient, flat design, clean edges"

カテゴリ別のテンプレートを含む包括的なプロンプトのリファレンスについては、references/prompts.md を参照してください。

---

エラー処理

エラー	解決策
google-genai package not installed	pip install google-genai Pillow を実行します
No API credentials found	GEMINI_API_KEY または GOOGLE_CLOUD_PROJECT を設定します
Content blocked by safety filters	制限対象のコンテンツを避けるよう、プロンプトを言い換えます
API rate limit reached	しばらく待ってから再試行します。バッチ操作では --delay を使用します
Image file not found	-i の入力パスが正しいことを確認します
SSL: CERTIFICATE_VERIFY_FAILED	--no-ssl-verify を使用するか、NANOBANANA_NO_SSL_VERIFY=1 を設定します