Image Creator

Image Creator - AI画像生成スキル

Google Gemini / OpenAI GPT Image / ZhipuAI GLM-Image / fal.ai を使った画像生成・編集。

詳細なCLIオプション・モデルID・全ワークフローは docs/reference.md を必要時に参照。

デフォルト設定（明示指示がない場合に適用）

強制ではなく推奨デフォルト。ユーザー指示があればそちらを優先。

Step 0: ユースケース判定（最初に実行・質問は最小限）

技術詳細（プロバイダー等）より先に「何を作りたいか」を下の 5 タイプに当てはめる。依頼文・添付・直前の会話で タイプが一意に定まるなら AskUserQuestion を使わず、そのまま次のステップへ進む（例: 「YouTube のサムネ作って」→ リッチ画像、「透過のアイコンを 3 つ」→ シンプル画像（透過）、「この手順を図解して」→ Step 0.5）。

画像タイプ5択

複数タイプに読めて、どれを取るかで生成物が別物になるときだけ AskUserQuestion で 1 問（上の 5 択、推奨を先頭）。 迷う程度なら既定（一般的なイラスト・写真＝無課金の codex 経路）で 1 枚作り、外れていれば作り直す方が速い。 残り 4 タイプは従量課金の経路（Gemini / OpenAI / GLM）なので、そちらへ倒すか迷うときは先に無課金経路で試す。

Step 0.5: 図種サジェストテーブル

「説明図・図解・比較図」に判定した場合（「〇〇を図にして」「〇〇を可視化して」等）、以下から最も近い行を 1 つ選び、推奨図種の先頭で進む。伝えたい内容が表の複数の行に当てはまり、図種で成果物が別物になるときだけ、推奨図種 top3 を AskUserQuestion で 1 問提示する（推奨を先頭に置く）。

判定ルール:

• 構造記法系（フロー/シーケンス/ER/ガント/組織図）→ 図形の正確性重視 → mermaid-to-webp にルーティング
• ビジュアル発信系（ビジュアルアブストラクト/インフォグラフィック/BMC/ジャーニー）→ レイアウト自由度重視 → generate_rich.py

Step 1: ツール選択マトリクス

プロバイダー別の強み

• Codex サブスク枠（既定）: ChatGPTログイン認証で gpt-image-2 を無課金利用。汎用生成の既定。ただし size/quality/厳密比率は制御不可・透過不可（→ 必要時は OpenAI へ）
• Gemini: 日本語理解・参照画像スタイルコピー・フォールバックチェーン豊富
• OpenAI: 高品質・ネイティブ透過背景・正確なサイズ/2K/4K・複数枚同時生成（-n）。従量課金
• GLM-Image: 日中テキスト描画精度91.16%、低コスト（$0.015/枚）
• fal.ai: Gemini障害時の自動フォールバック（GPT Image 1.5）

モデル選択ヒューリスティック

Gemini:

• 既定 nb2 - Pro品質+Flash速度・参照画像10枚・thinking制御（Preview）
• キャラクター一貫性重視 → pro（Preview）
• 速度・安定性（GA）優先 → flash

OpenAI:

• 既定 gpt-image-2 - 最新・最高品質・テキスト描画強
• 透過背景 → gpt-image-1.5 に自動フォールバック（-b transparent時）
• 軽量・低コスト → gpt-image-1-mini

Step 2: リッチ画像モード（generate_rich.py）

パターン/モード対応表

キャラクタープリセット（--character-preset）

default / idol / vtuber / business / tech / teacher / mascot / cool

詳細は --list-presets で取得可能。

追加で決める項目（会話から読み取り、読めなければ既定）

• サムネイル: スタイル（アニメ/ビジネス/写真。既定: ビジネス）、アニメ風なら雰囲気（驚き/インパクト/ポップ/明るい。既定: 明るい）、キャラクター有無（既定: なし）
• 説明図: タイプ（図解=graphrec / 比較=comparison / プロセス=process / カスタム。既定: 内容に最も近いもの、迷えば graphrec）

AskUserQuestion は、読み違えると生成物が別物になる 1 点だけに使う（例: アニメ風か写真風かで参照画像の扱いが変わるとき。推奨を先頭に置く）。それ以外は既定で 1 枚作り、結果を見てから直す。

Step 3: 推奨設定早見表

背景除去の選び方

ツール一覧

詳細オプションは各スクリプト --help または docs/reference.md 参照。

codex サブスク枠生成（無課金の既定経路）

Codex CLI 組み込みの built-in image_gen（gpt-image-2）を ChatGPT ログイン認証（サブスクリプション枠） で呼び出す。OPENAI_API_KEY を明示的に外して起動するため API 従量課金が発生しない。「何も指定しない汎用生成」の既定。

駆動側の Codex モデルはスクリプトに固定しない。~/.codex/light.config.toml（profile light）がある環境では -p light を自動付与し、無い環境では ~/.codex/config.toml の既定モデルに委ねる。profile 名は IMAGE_CREATOR_CODEX_PROFILE で差し替え可（空文字で無効化）。

# 可用性判定（利用可=exit 0 / 不可=exit 3）
uv run python scripts/generate_codex.py --check

# 生成（単発）
uv run python scripts/generate_codex.py "青空と一本桜のシンプルなイラスト" -o sakura.png

# 複数枚（共有スタイルで連続生成）／作り込みは effort を上げる
uv run python scripts/generate_codex.py "章扉の装飾" -n 3 --effort xhigh -o slide.png

前提:

• Codex CLI がインストール済みで、codex login により ChatGPT でログインしていること（API キー不要）。
• 未導入・未ログイン環境では exit 3 を返す。SKILL の既定ルーティングは自動で Gemini へフォールバックする。

制約（built-in image_gen 由来）:

• size/quality/厳密な比率を制御できない（--aspect は prose ヒントで、密な縦長内容では無視されがち）。
• 透過背景を出力できない。
• → 正確な比率・2K/4K・quality=high・透過が必要なときは generate_openai.py（従量課金） を使う。

品質向上（augment・既定ON）: built-in は size/quality を制御できないため、品質はプロンプト設計で引き上げる。generate_codex.py は既定で「専門デザイナー役の付与＋品質バー＋（構造的内容なら）レイアウト委譲・補助ラベル補完」を自動付与する（ユーザーの明示テイストは尊重し不要な装飾は足さない）。これが effort より効く最大の品質レバー。特にインフォグラフィック・図解・ポスターで顕著。--no-augment で無効化可。

• effort の目安: 単発の簡単な画像は low、作り込み（インフォグラフィック・図解・複数枚のスタイル統一）は high/xhigh。effort を上げても解像度は伸びない（built-in 上限〜1〜2K）。
• 比率: --aspect は向き（portrait/landscape/square）を強い prose で誘導する。向きの一貫性は上がるが、解像度・厳密な比率は built-in の制御外（ピクセル固定が要る納品物は generate_openai.py -s の従量課金経路へ）。

偽装検証（自動）: codex は稀に image_gen を呼ばず SVG/PIL 等で自作した画像や既存流用で「生成した」と偽装する。本スクリプトはプロンプトの偽装禁止文言＋「codex が報告した生成パスが開始マーカーより新しい実ファイルであること」の検証で弾く（検証に落ちると exit 2）。報告パスを正典とするため、複数セッション同時実行時も他セッションの生成物と混同しない。

トークン期限切れ: 認証エラー（token_expired/unauthorized 等）検出時は exit 4。ユーザーに ! codex login（対話 OAuth、Claude 代行不可）での再ログインを依頼する。

重要ワークフロー（非自明なもの）

透過アイコン（最も簡単）

uv run --with openai --with pillow scripts/generate_openai.py \
  "シンプルな星のアイコン" -b transparent -o star.png

ステッカーシート生成 → 分割

# 1. マゼンタ背景で複数配置生成（LARGE gaps で重なり回避）
uv run --with google-genai --with pillow scripts/generate.py \
  "Multiple separate kawaii stickers with LARGE gaps: coffee cup, donut, cat, star. Arranged in 2x2 grid, well separated." \
  --magenta-bg -o sheet.png

# 2. 背景透過
uv run --with pillow --with numpy --with scipy scripts/remove-bg-magenta.py sheet.png

# 3. 個別分割
uv run --with opencv-python --with numpy scripts/split_transparent.py sheet.png ./stickers/

プロンプトのコツ: LARGE gaps between them, well separated, Arranged in XxY grid

参照画像スタイルコピー + 透過

# 1. 参照画像のスタイルで生成（スタイル維持のためマゼンタ指定なし）
uv run --with google-genai --with pillow scripts/generate.py \
  "Same exact style as this image. Object: coffee cup. NO text." \
  -r reference.png -o coffee.png

# 2. Vision API で背景除去
python3 scripts/remove-bg-vision.py coffee.png

複数枚同時生成（OpenAI）

uv run --with openai --with pillow scripts/generate_openai.py \
  "かわいい動物のアイコン、1つの動物" -n 5 -b transparent -o animal.png
# → animal_01.png, animal_02.png, ... が生成される

テキスト入り画像（GLM-Image）

uv run --with requests --with pillow scripts/generate_zhipu.py \
  "「祝・開店」と書かれた和風バナー" -o banner.png

耐障害性・フォールバック

Gemini のフォールバックチェーン

• Pro → codex（無課金） → OpenAI gpt-image-2 → NB2 → fal.ai → Flash
• NB2 → codex（無課金） → OpenAI gpt-image-2 → fal.ai → Flash
• OpenAI gpt-image-2 への段は API 従量課金なので、ALLOW_OPENAI_API_BILLING=1 を明示したときだけ使う（未指定ならスキップして次の段へ。OPENAI_API_KEY があるだけでは使わない）
• Flash は GA モデルで最安定
• codex サブスク枠（無課金）を従量課金 OpenAI の前段に置き、コストを最小化

条件

• codex フォールバック: codex CLI＋ChatGPT ログイン時のみ（不可なら静かに次へ）。参照画像指定時は比率制御不可のためスキップ
• OpenAI フォールバック: OPENAI_API_KEY 設定時のみ。参照画像指定時は edit API の差異でスキップ
• fal.ai フォールバック: FAL_AI_API_KEY 設定時のみ
• --no-fallback でチェーン無効化

リトライ・タイムアウト

• 503/429/408 は最大2回の指数バックオフ（10秒→20秒）。504 は即フォールバック
• NB2/Pro: 300秒、Flash: 600秒、OpenAI: 180秒、fal.ai: 120秒

Note: NB2/Pro は Preview 段階。サーバー過負荷による 503/504 があり得る。最高安定性が必要なら Flash（GA）を直接指定。

前提条件

• uv インストール: curl -LsSf https://astral.sh/uv/install.sh | sh
• macOS Vision API 使用時: macOS 14.0 (Sonoma) 以降

環境変数