nanobanana

Nano Banana - AI 画像生成

Google の Gemini 3 Pro Image モデル（gemini-3-pro-image-preview、「Nano Banana Pro」🍌の愛称で知られています）を使用して、画像を生成・編集します。

前提条件

必須：

• GEMINI_API_KEY - Google AI Studio から取得します
• google-genai パッケージを含む Python 3.10 以降

依存関係をインストール：

pip install google-genai pillow

クイックスタート

画像を生成：

python3 <skill_dir>/scripts/generate.py "a cute robot mascot, pixel art style" -o robot.png

既存の画像を編集：

python3 <skill_dir>/scripts/generate.py "make the background blue" -i input.jpg -o output.png

縦横比を指定して生成：

python3 <skill_dir>/scripts/generate.py "cinematic landscape" --ratio 21:9 -o landscape.png

高解像度の 4K 画像を生成：

python3 <skill_dir>/scripts/generate.py "professional product photo" --size 4K -o product.png

スクリプトリファレンス

scripts/generate.py

メインの画像生成スクリプトです。

Usage: generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              Text prompt for image generation

Options:
  -o, --output PATH   Output file path (default: auto-generated)
  -i, --input PATH    Input image for editing (optional)
  -r, --ratio RATIO   Aspect ratio (1:1, 16:9, 9:16, 21:9, etc.)
  -s, --size SIZE     Image size: 2K or 4K (default: standard)
  --search            Enable Google Search grounding for accuracy
  -v, --verbose       Show detailed output

対応する縦横比：

• 1:1 - 正方形（デフォルト）
• 2:3、3:2 - 縦長／横長
• 3:4、4:3 - 標準
• 4:5、5:4 - 写真
• 9:16、16:9 - ワイドスクリーン
• 21:9 - ウルトラワイド／シネマティック

scripts/batch_generate.py

連番のファイル名で複数の画像を生成します。

Usage: batch_generate.py [OPTIONS] PROMPT

Arguments:
  PROMPT              Text prompt for image generation

Options:
  -n, --count N       Number of images to generate (default: 10)
  -d, --dir PATH      Output directory
  -p, --prefix STR    Filename prefix (default: "image")
  -r, --ratio RATIO   Aspect ratio
  -s, --size SIZE     Image size (2K/4K)
  --delay SECONDS     Delay between generations (default: 3)

例：

python3 <skill_dir>/scripts/batch_generate.py "pixel art logo" -n 20 -d ./logos -p logo

Python API

モジュールを直接使用することもできます。

from generate import generate_image, edit_image

# Generate image
result = generate_image(
    prompt="a futuristic city at night",
    output_path="city.png",
    aspect_ratio="16:9",
    image_size="4K"
)

# Edit existing image
result = edit_image(
    prompt="add flying cars to the sky",
    input_path="city.png",
    output_path="city_edited.png"
)

環境変数

変数	説明	デフォルト
GEMINI_API_KEY	Google Gemini API キー	必須
IMAGE_OUTPUT_DIR	デフォルトの出力ディレクトリ	./nanobanana-images

機能

テキストからの画像生成

テキストによる説明から画像を作成します。このモデルは次の生成を得意としています。

• 写実的な画像
• アーティスティックなスタイル（ピクセルアート、イラストなど）
• 商品写真
• 風景やシーン

画像編集

自然言語で既存の画像を変換します。

• スタイル変換
• オブジェクトの追加／削除
• 背景の変更
• 色の調整

高解像度の出力

• 標準：高速に生成でき、品質も良好です
• 2K：ディテールを強化します（2048px）
• 4K：最高品質です（3840px）。テキストの描画に最適です

Google 検索によるグラウンディング

--search を有効にすると、次のような対象を含む、事実に基づいた正確な画像を生成できます。

• 実在の人物、場所、ランドマーク
• 時事問題
• 特定の商品やブランド

ベストプラクティス

プロンプトの作成

良いプロンプトに含める内容：

• 被写体の説明
• スタイル／美的表現
• 照明と雰囲気
• 構図の詳細
• カラーパレット

例：

"A cozy coffee shop interior, warm lighting, vintage aesthetic, 
wooden furniture, plants on shelves, morning sunlight through windows, 
soft focus background, 35mm film photography style"

バッチ生成のヒント

1. 選択肢を検討するため、10～20 種類のバリエーションを生成します
2. スタイルに一貫性を持たせるため、プロンプトを統一します
3. レート制限を回避するため、3～5 秒の間隔を設けます
4. 結果を確認し、有望な候補をもとに改善を重ねます

レート制限

• Gemini API には使用量の上限があります
• バッチ生成の間に間隔を設けます
• Google AI Studio で使用量の上限を確認します

トラブルシューティング

「API キーが見つかりません」

• GEMINI_API_KEY 環境変数を設定します
• または、--api-key オプションで渡します

「レスポンスに画像がありません」

• プロンプトが安全性フィルターに抵触した可能性があります
• センシティブな内容を避けるよう、表現を変えてみてください

「レート制限を超えました」

• 数秒待ってから再試行します
• バッチサイズを小さくするか、間隔を長くします

参考資料

• references/prompts.md - カテゴリー別のプロンプト例
• examples/ - 使用例のスクリプト