nanobana - SKILL.md Agent Skill

name: nanobana description: Nano Banana Pro (Gemini 3 Pro) で画像を生成・編集する。画像生成、イラスト作成、画像編集、ロゴ作成、バナー作成などのリクエストで使用する。 argument-hint: "[プロンプト] [--aspect 16:9] [--size 2K] [--input image.png]" allowed-tools: Bash(curl ), Bash(base64 ), Bash(mkdir ), Bash(cat ), Bash(echo ), Bash(source ), Bash(export ), Bash(set ), Bash(grep *), Read, Glob

Nano Banana Pro 画像生成スキル

Nano Banana Pro (Gemini 3 Pro Image Preview) APIを使って画像を生成・編集する。

前提条件

プロジェクトルートの .env ファイルから GEMINI_API_KEY を読み込む。

APIキーの読み込み

毎回最初に必ず実行すること:

set -a && source .env && set +a

.env が見つからない、または GEMINI_API_KEY が空の場合はユーザーに以下を案内して停止する:

プロジェクトルートの .env ファイルに以下を追加してください:
GEMINI_API_KEY=your-api-key

API仕様

エンドポイント: https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent
メソッド: POST
認証: クエリパラメータ key=$GEMINI_API_KEY

実行手順

1. .env 読み込みとAPIキー確認

set -a && source .env && set +a && echo "GEMINI_API_KEY=${GEMINI_API_KEY:+OK}"

OK が出なければ .env の設定を案内して停止する。

2. 出力ディレクトリの準備

mkdir -p ./generated

3. API呼び出し

テキストから画像生成の場合:

curl -s -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-3-pro-image-preview:generateContent?key=${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "プロンプト内容"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "1:1",
        "imageSize": "1K"
      }
    }
  }' -o /tmp/nanobana_response.json

既存画像を編集する場合:

入力画像をbase64エンコードして inline_data に含める:

BASE64_IMG=$(base64 < input.png)

リクエストの parts に追加:

{"inline_data": {"mime_type": "image/png", "data": "<base64>"}}

4. レスポンス解析と画像保存

# 画像データを抽出して保存
cat /tmp/nanobana_response.json | jq -r '.candidates[0].content.parts[] | select(.inline_data) | .inline_data.data' | base64 -d > ./generated/nanobana_$(date +%Y%m%d_%H%M%S).png

# テキストレスポンスも取得
cat /tmp/nanobana_response.json | jq -r '.candidates[0].content.parts[] | select(.text) | .text'

5. エラーハンドリング

APIエラーの場合:

cat /tmp/nanobana_response.json | jq -r '.error.message // empty'

画像が含まれていない場合はユーザーにプロンプトの修正を提案する。

パラメータリファレンス

パラメータ	値	デフォルト
aspectRatio	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`	`1:1`
imageSize	`1K`, `2K`, `4K`	`1K`

使用例

ユーザーが「猫のイラストを生成して」と言った場合:

APIキーを確認
プロンプトを英語に翻訳（精度向上のため）
APIを呼び出し
生成画像を ./generated/ に保存
保存パスをユーザーに報告し、Read ツールで画像を表示

ユーザーが「この画像の背景を変えて」と言った場合:

入力画像をbase64エンコード
編集指示とともにAPIを呼び出し
結果を保存・表示

注意事項

プロンプトは英語の方が高精度。日本語入力は英語に翻訳してからAPIに送る
生成画像にはSynthIDの透かしが含まれる
4Kサイズはコストが高いため、必要な場合のみ使用
/tmp/nanobana_response.json は一時ファイル。毎回上書きされる
生成後は Read ツールで画像をユーザーに表示すること