Nano Banana - AI Image Generation

Google の Gemini 3 Pro Image モデル (gemini-3-pro-image-preview、別名「Nano Banana Pro」🍌) を使用して画像を生成・編集します。

前提条件

必須:

• GEMINI_API_KEY - Google AI Studio から取得
• Python 3.10 以上と google-genai パッケージ

依存関係のインストール:

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

# 画像を生成
result = generate_image(
    prompt="a futuristic city at night",
    output_path="city.png",
    aspect_ratio="16:9",
    image_size="4K"
)

# 既存の画像を編集
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 グラウンディング

以下を含む事実的に正確な画像には --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 key not found"

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

"No image in response"

• プロンプトがセーフティフィルターをトリガーした可能性があります
• センシティブなコンテンツを避けるために言い換えてみてください

"Rate limit exceeded"

• 数秒待機して再試行
• バッチサイズを削減または遅延を長くする

リファレンス

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