# CLI画像生成3ルート shadow実装結果（2026-06-07 実機検証）

> [[CLIから画像生成できるAI 総まとめ X+YouTube学習 2026-06-07]](id=528)の調査を受け、shadowに3ルートを実装し**実機検証**した結果。机上調査と実機で結論が変わった部分あり。

## 結論（実機で確定）

**無料で使える本命は2つ。Geminiは无料枠廃止で脱落した。**

| ルート | 実機結果 | 無料か |
|--------|---------|:---:|
| **① Grok Imagine** | ✅ 実働（青ロボ・桜庭園・緑カエル生成成功） | ✅ X Premiumサブスク内・追加課金なし |
| **③ Codex `$imagegen`** | ✅ 実働（緑カエル生成成功・gpt-image-2） | ✅ ChatGPTサブスク内・追加課金なし |
| **② Gemini Nano Banana** | ❌ `429 limit:0` / `Imagen 3 paid plans only` | ❌ **無料枠廃止・課金必須** |

## ① Grok Imagine（実装済・本命）
- スクリプト: `~/.claude/scripts/grok_imagine.py`
- `python3 ~/.claude/scripts/grok_imagine.py "プロンプト" -n 1 -o ./out`
- xAI `/v1/images/generations`・モデル`grok-imagine-image`・X Premium OAuth(`~/.hermes/auth.json`)
- 出力1024x1024 JPEG。日本語プロンプトも通る
- **Gotcha**: 画像CDN `imgen.x.ai` は素のUAを `error 1010` でブロック→ブラウザ風UAでDL（対応済）
- **Gotcha**: `grok-2-image-1212`は2026-02-24廃止→`grok-imagine-image`を使う

## ③ Codex `$imagegen`（実装確認済）
- `codex exec --dangerously-bypass-approvals-and-sandbox --cd "$PWD" '$imagegen で…生成して'`
- gpt-image-2・APIキー不要・保存先`~/.codex/generated_images/`
- **Gotcha**: サブスク利用枠を消費。`You've hit your usage limit ... try again at HH:MM`で上限到達→回復時刻まで待つ（今回17:57回復を実体験）
- `auth_mode=chatgpt`を`~/.codex/auth.json`で確認（OPENAI_API_KEYが効くと従量課金）

## ② Gemini Nano Banana（❌無料不可・要課金）
- 拡張は導入完了: `~/.local/share/gemini-extensions/nanobanana`（link・MCPビルド・キー設定済）
- **実機で無料枠が`limit:0`と判明**。全画像モデル(gemini-2.5-flash-image/gemini-3.1-flash-image/imagen-4.0系)が429
- Imagenは明示的に `Imagen 3 is only available on paid plans` を返す
- **当初「Googleログインだけ無料」としたのは2026年6月時点で誤り**。GMOの解説記事(古い)に基づく誤認だった
- キー自体は有効・8画像モデルにアクセス可。billing有効化(https://ai.dev/projects)すれば動く
- インストール時Gotcha: `gemini extensions install/link`はワークスペース信頼[Y/n]でハング→`printf 'y\n' |`で突破。`/dev/null`はNG。公式install(github-url)はnpm install+ビルド+対話で固まる→手動clone→build→`extensions link`が確実。settings配列があるとAPIキー入力プロンプトでハング→除去しenv参照化

## 教訓（横断）
- **机上の「無料」は実機で裏取りする**。料金体系は頻繁に変わる（Geminiは2026に画像生成を有料化）
- サブスク既保有なら、Grok(X Premium)とCodex(ChatGPT)の2つで画像生成は十分カバーできる
- 全て非中華(xAI/OpenAI/Google)でポリシー適合

## 成果物
- `~/.claude/scripts/grok_imagine.py`（Grokラッパー・実働）
- `~/.claude/rules/cli-image-generation.md`（3ルート運用ガイド・訂正済）
- `/home/ubuntu/workspace/generated-images/`（生成画像: grok-blue-robot-icon / grok-sakura-garden / codex-green-frog）