Gemini API(Nano Banana)を利用して画像生成・画像編集を行う。「画像を生成して」「画像を作って」「イラストを描いて」「画像を編集して」「この画像を修正して」などのリクエストで積極的に使用すること。
Gemini API の画像生成モデル(Nano Banana シリーズ)を使って、テキストプロンプトから画像を生成する。 また、既存の画像ファイルを入力として渡すことで、画像の編集(背景変更・スタイル変換・要素の追加/削除など)も可能。
| エイリアス | Gemini モデル ID | 特徴 |
|---|---|---|
| Nano Banana 2(デフォルト) | gemini-3.1-flash-image-preview | 高効率・速度重視 |
| Nano Banana Pro | gemini-3-pro-image-preview | 高忠実度・プロ向け |
| Nano Banana | gemini-2.5-flash-image | 低レイテンシ最適化 |
GEMINI_IMAGE_MODEL でモデルを固定変更可能
nano-banana-2(デフォルト)nano-banana-pronano-bananaAskQuestion ツールを使って、以下の情報をユーザーに確認する。
reports/generated-images/ 内のパスを指定.png, .jpg, .jpeg, .webp, .gif1:1 — 正方形(SNS アイコン、Instagram 投稿向け)16:9 — 横長ワイド(プレゼン、YouTube サムネイル向け)9:16 — 縦長(スマホ壁紙、Stories 向け)4:3 — 標準横長(ブログ記事、Web バナー向け)3:4 — 標準縦長(ポスター、チラシ向け)ユーザーがプロンプトだけ指示し、サイズ等を特に気にしていない場合は、
アスペクト比のデフォルト 1:1 で進めてよい。
基本構文:
# 新規生成
bun run gemini:image -- --prompt "<プロンプト>" --aspect <比率>
# 画像編集
bun run gemini:image -- --image "<入力画像パス>" --prompt "<編集指示>" --aspect <比率>
オプション:
--prompt <テキスト> — 画像生成/編集プロンプト(必須)--image <パス> — 入力画像ファイルパス(指定すると画像編集モード)
.png, .jpg, .jpeg, .webp, .gif--aspect <比率> — アスペクト比(デフォルト: 1:1)
1:1, 16:9, 9:16, 4:3, 3:4--output <パス> — 出力ファイルパス(デフォルト: reports/generated-images/ 配下に自動生成)--help — ヘルプを表示実行例(新規生成):
# 正方形で猫のイラスト
bun run gemini:image -- --prompt "かわいい猫のイラスト、水彩画風" --aspect 1:1
# 横長ワイドで風景画
bun run gemini:image -- --prompt "夕焼けの富士山、浮世絵風" --aspect 16:9
# 出力先を指定
bun run gemini:image -- --prompt "ロゴデザイン" --aspect 1:1 --output reports/logo-draft.png
実行例(画像編集):
# 生成済み画像の背景を変更
bun run gemini:image -- --image reports/generated-images/cat.png --prompt "背景を青空に変更して"
# 添付画像を水彩画風に変換
bun run gemini:image -- --image /tmp/photo.jpg --prompt "水彩画風に変換して" --aspect 16:9
# 画像から要素を削除
bun run gemini:image -- --image reports/generated-images/logo.png --prompt "テキストを削除して背景だけにして"
スクリプトの stdout 出力(JSON)を読み取り、以下を報告する:
ReadFile ツールで生成された画像ファイルを読み込み、ユーザーに表示するGEMINI_API_KEY が設定されていることbun run gemini:image が ./scripts/dotenvx-keychain.sh 経由で起動されるため、Keychain または .env に設定済みであればそのまま利用できる.env に GEMINI_API_KEY=取得したキー を追加tasks/gemini-image.tstasks/lib/gemini-image.tsreports/generated-images/# 新規生成
/gemini-image 富士山の水彩画風イラストを生成して
/gemini-image かわいい猫のアイコンを作って(正方形で)
/gemini-image プレゼン用のヘッダー画像を横長ワイドで生成して
# 画像編集
/gemini-image さっき生成した猫の画像の背景を青空にして
/gemini-image この画像を水彩画風に変換して(画像ファイル添付あり)
/gemini-image reports/generated-images/logo.png のテキストを削除して