canghe-image-gen

画像生成（AI SDK）

公式 API に基づく画像生成です。OpenAI、Google、DashScope（阿里通义万象）、Canghe に対応しています。

スクリプトディレクトリ

エージェントの実行：

1. SKILL_DIR = この SKILL.md ファイルのディレクトリ
2. スクリプトのパス = ${SKILL_DIR}/scripts/main.ts

設定（EXTEND.md）

Bash を使用して EXTEND.md が存在するか確認します（優先順位順）：

# Check project-level first
test -f .canghe-skills/canghe-image-gen/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.canghe-skills/canghe-image-gen/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ パス │ 場所 │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .canghe-skills/canghe-image-gen/EXTEND.md │ プロジェクトディレクトリ │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.canghe-skills/canghe-image-gen/EXTEND.md │ ユーザーホーム │ └──────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ 結果 │ アクション │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 見つかった │ 読み込み、解析し、設定を適用 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 見つからない │ デフォルトを使用 │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md で設定できる項目：デフォルトのプロバイダー | デフォルトの品質 | デフォルトのアスペクト比 | デフォルトの画像サイズ | デフォルトのモデル

スキーマ：references/config/preferences-schema.md

使用方法

# Basic
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image cat.png

# With aspect ratio
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A landscape" --image out.png --ar 16:9

# High quality
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --quality 2k

# From prompt files
npx -y bun ${SKILL_DIR}/scripts/main.ts --promptfiles system.md content.md --image out.png

# With reference images (Google multimodal or OpenAI edits)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --ref source.png

# With reference images (explicit provider/model)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "Make blue" --image out.png --provider google --model gemini-3-pro-image-preview --ref source.png

# Specific provider
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "A cat" --image out.png --provider openai

# DashScope (阿里通义万象)
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider dashscope

# Canghe third-party gateway
npx -y bun ${SKILL_DIR}/scripts/main.ts --prompt "一只可爱的猫" --image out.png --provider canghe

オプション

オプション	説明
--prompt <text>, -p	プロンプトのテキスト
--promptfiles <files...>	ファイルからプロンプトを読み込みます（連結）
--image <path>	出力画像のパス（必須）
--provider google|openai|dashscope|canghe	プロバイダーを指定します（デフォルト：google）
--model <id>, -m	モデル ID（OpenAI で --ref を使用する場合は、gpt-image-1.5 などの GPT Image モデルが必要です）
--ar <ratio>	アスペクト比（例：16:9、1:1、4:3）
--size <WxH>	サイズ（例：1024x1024）
--quality normal|2k	品質プリセット（デフォルト：2k）
--imageSize 1K|2K|4K	Google の画像サイズ（デフォルト：品質設定に準拠）
--ref <files...>	参照画像。Google マルチモーダル、OpenAI の編集（GPT Image モデル）、Canghe（image_url）に対応しています。プロバイダーを省略した場合は、Google、OpenAI、Canghe の順に選択します
--n <count>	画像の枚数
--json	JSON 形式で出力

環境変数

変数	説明
OPENAI_API_KEY	OpenAI API キー
GOOGLE_API_KEY	Google API キー
DASHSCOPE_API_KEY	DashScope API キー（阿里云）
CANGHE_API_KEY	Canghe API キー
OPENAI_IMAGE_MODEL	OpenAI モデルの上書き設定
GOOGLE_IMAGE_MODEL	Google モデルの上書き設定
DASHSCOPE_IMAGE_MODEL	DashScope モデルの上書き設定（デフォルト：z-image-turbo）
CANGHE_IMAGE_MODEL	Canghe モデルの上書き設定（デフォルト：gemini-3-pro-image-preview）
OPENAI_BASE_URL	カスタム OpenAI エンドポイント
GOOGLE_BASE_URL	カスタム Google エンドポイント
DASHSCOPE_BASE_URL	カスタム DashScope エンドポイント
CANGHE_BASE_URL	カスタム Canghe エンドポイント（デフォルト：https://api.canghe.ai/v1）

読み込みの優先順位：CLI 引数 > EXTEND.md > 環境変数 > <cwd>/.canghe-skills/.env > ~/.canghe-skills/.env

プロバイダーの選択

1. --ref が指定されていて --provider がない場合 → Google、OpenAI、Canghe の順に自動選択します
2. --provider が指定されている場合 → 指定されたプロバイダーを使用します（--ref を指定する場合は、google、openai、canghe のいずれかである必要があります）
3. API キーが 1 つだけ使用可能な場合 → そのプロバイダーを使用します
4. 複数の API キーが使用可能な場合 → デフォルトで Google を使用します

品質プリセット

プリセット	Google imageSize	OpenAI Size	用途
normal	1K	1024px	クイックプレビュー
2k (デフォルト)	2K	2048px	表紙、イラスト、インフォグラフィック

Google imageSize：--imageSize 1K|2K|4K で上書きできます

アスペクト比

対応：1:1、16:9、9:16、4:3、3:4、2.35:1

• Google マルチモーダル：imageConfig.aspectRatio を使用します
• Google Imagen：aspectRatio パラメーターを使用します
• OpenAI：最も近い対応サイズにマッピングします

生成モード

デフォルト：逐次生成（一度に画像を1枚生成）。これにより、安定した出力が得られ、デバッグも容易になります。

並列生成：ユーザーが並列／同時生成を明示的にリクエストした場合にのみ使用します。

モード	使用する状況
逐次（デフォルト）	通常の使用、単一画像、小規模なバッチ
並列	ユーザーが明示的にリクエストした場合、大規模なバッチ（10枚以上）

並列設定（リクエストされた場合）：

設定	値
推奨同時実行数	サブエージェント4つ
最大同時実行数	サブエージェント8つ
用途	ユーザーが並列生成をリクエストした場合の大規模バッチ生成

エージェントの実装（並列モードのみ）：

# Launch multiple generations in parallel using Task tool
# Each Task runs as background subagent with run_in_background=true
# Collect results via TaskOutput when all complete

エラー処理

• API キーがない場合 → 設定手順を含むエラー
• 生成に失敗した場合 → 自動で1回再試行
• 無効なアスペクト比 → 警告を表示し、デフォルトで続行
• 対応していないプロバイダー／モデルで参照画像を使用した場合 → 修正方法のヒントを含むエラー（Google マルチモーダルまたは OpenAI GPT Image edits に切り替えてください）

拡張機能のサポート

EXTEND.md でカスタム設定ができます。パスと対応オプションについては、Preferences セクションを参照してください。