Nano Banana Pro OpenRouter

概要

OpenRouter で google/gemini-3-pro-image-preview モデルを使用して画像を生成または編集します。プロンプトのみによる生成、単一画像の編集、複数画像の合成に対応しています。

プロンプトのみで生成

uv run {baseDir}/scripts/generate_image.py \
  --prompt "A cinematic sunset over snow-capped mountains" \
  --filename sunset.png

単一画像を編集

uv run {baseDir}/scripts/generate_image.py \
  --prompt "Replace the sky with a dramatic aurora" \
  --input-image input.jpg \
  --filename aurora.png

複数画像を合成

uv run {baseDir}/scripts/generate_image.py \
  --prompt "Combine the subjects into a single studio portrait" \
  --input-image face1.jpg \
  --input-image face2.jpg \
  --filename composite.png

解像度

• --resolution に 1K、2K、または 4K を指定できます。
• 指定がない場合のデフォルトは 1K です。

システムプロンプトのカスタマイズ

このスキルは、assets/SYSTEM_TEMPLATE から任意のシステムプロンプトを読み込みます。これにより、コードを修正することなく画像生成の動作をカスタマイズできます。

動作と制約

• --input-image を繰り返して、最大 3 つの入力画像を受け付けます。
• --filename には相対パス（現在のディレクトリに保存）または絶対パスを指定できます。
• 複数の画像が返された場合、ファイル名に -1、-2 などを追加します。
• 保存した画像ごとに MEDIA: <path> を出力してください。保存後、画像を応答に読み込み直さないでください。

トラブルシューティング

スクリプトが 0 以外で終了した場合、stderr をこれらの一般的な問題と照らし合わせてください。

症状	解決方法
OPENROUTER_API_KEY is not set	ユーザーに設定するよう依頼してください。PowerShell: $env:OPENROUTER_API_KEY = "sk-or-..." / bash: export OPENROUTER_API_KEY="sk-or-..."
uv: command not found または認識されない	macOS/Linux: <code>curl -LsSf https://astral.sh/uv/install.sh | sh</code>。Windows: <code>powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"</code>。その後、ターミナルを再起動してください。
AuthenticationError / HTTP 401	キーが無効であるか、クレジットがありません。https://openrouter.ai/settings/keys で確認してください。

一時的なエラー（HTTP 429、ネットワークタイムアウト）の場合は、30 秒後に 1 回再試行してください。同じエラーを 2 回以上再試行しないでください。代わりに、その問題をユーザーに通知してください。