mcpField
I
image-gen

image-gen

github.com/redfox-dataクリエイティブ・メディア450280 回インストール2 日前に更新
リポジトリ

image-gen について

OpenAIのgpt-image-2を使って画像を生成・編集するコマンドラインスキルです。画像制作をスクリプト化したい人向けで、複数枚の生成やアスペクト比、解像度の指定に対応します。

主な機能

  1. 01テキストから画像を生成
  2. 02最大2枚の参照画像で編集
  3. 031回につき最大4枚を生成
  4. 04アスペクト比と解像度の指定
  5. 05タスクの送信と結果の照会

活用シーン

  1. 01マーケティング画像やイラストの一括生成
  2. 02参照画像をもとにした対象やスタイルの変更
  3. 03指定比率でのSNSカバー画像の作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redfox-data/redfox-community --skill image-gen

インストール後、Claude Code で/image-genを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.en.md
README.md
assets/
imagegen.py

詳細

GPT-image2

OpenAI 最新の gpt-image-2 モデルを呼び出して、高品質な画像を生成します。プロンプトを貼り付けるだけで使えます。

Skill の特長

  • コマンドラインでの一括生成、アスペクト比と解像度の段階を指定した制御に対応しています
  • テキストから画像生成＋画像から画像生成の2つのモードに対応し、--image パラメーター1つで編集モードを有効にできます（参考画像は最大2枚）

機能概要

  • テキストから画像生成：プロンプトを入力して、新しい画像を生成します
  • 画像から画像生成：参考画像（最大2枚）＋プロンプトを入力し、元画像を基に編集して生成します
  • モデル：gpt-image-2（OpenAI の最新画像モデル）
  • インターフェース：Redfox の新しい gptImage2Submit / gptImage2Result
  • 出力形式：PNG（新しいインターフェースでは固定出力）
  • アスペクト比：1:1 / 3:2 / 2:3 / 4:3 / 3:4 / 5:4 / 4:5 / 16:9（デフォルト） / 9:16 / 2:1 / 1:2 / 21:9 / 9:21
  • 解像度の段階：1k / 2k（デフォルト） / 4k
  • 一括生成：1回につき最大4枚（新しいインターフェースの上限）
  • 旧ピクセル形式との互換性：1792x1024 などの旧形式も引き続き受け付け、スクリプト内部でアスペクト比＋段階に自動変換します

使用方法

テキストから画像生成 — テキストを入力して画像を生成
# 基本生成（默认 16:9 + 2k）
python3 "$SKILL_PATH/assets/imagegen.py" "一只橘色的猫咪坐在窗台上看着窗外的夕阳"

# 横版 4k 高清
python3 "$SKILL_PATH/assets/imagegen.py" "futuristic city skyline" --size 16:9 --resolution 4k

# 竖版小红书封面（3:4 + 2k）
python3 "$SKILL_PATH/assets/imagegen.py" "product cover, minimal style" --size 3:4 --resolution 2k

# 方形 1k 快速档
python3 "$SKILL_PATH/assets/imagegen.py" "minimalist cat logo, flat design" --size 1:1 --resolution 1k

# 批量生成 4 张（新接口上限）
python3 "$SKILL_PATH/assets/imagegen.py" "icon set, flat style" -n 4

# 兼容旧像素写法（自动映射为 16:9 + 1k）
python3 "$SKILL_PATH/assets/imagegen.py" "cyberpunk street" --size 1792x1024
画像から画像生成 — 参考画像をアップロードして編集・生成
# 单张参考图（自动上传 OSS → 提交任务）
python3 "$SKILL_PATH/assets/imagegen.py" "把猫咪改成白色，背景换成星空" --image ~/Pictures/cat.png

# 两张参考图（新接口最多支持 2 张）
python3 "$SKILL_PATH/assets/imagegen.py" "融合两张图的风格" --image ref1.png --image ref2.jpg

# 直接使用 URL 参考图（跳过上传步骤）
python3 "$SKILL_PATH/assets/imagegen.py" "把海报主体换成手表" --image "https://example.com/poster.jpg"
その他の操作
# 仅提交任务（返回 taskId，不等待）
python3 "$SKILL_PATH/assets/imagegen.py" "complex scene" --no-download

# 查询已有任务结果
python3 "$SKILL_PATH/assets/imagegen.py" "" --task-id 5f100fcb8f3c4e3087c6aba93e121f7e

# 指定输出目录和文件名前缀
python3 "$SKILL_PATH/assets/imagegen.py" "illustration" -o ~/Pictures/AI --prefix artwork
パラメーターの説明
パラメーター説明デフォルト値
prompt生成・編集用プロンプト（必須、最大500文字）-
--sizeアスペクト比（例：16:9）。旧ピクセル形式（例：1792x1024）にも対応しています16:9
--resolution解像度の段階：1k / 2k / 4kピクセル形式の場合は自動的に一致する値を設定。アスペクト比の場合はデフォルトで 2k
-n, --count生成数（1～4、新しいインターフェースの上限は4）1
--image参考画像のパスまたは URL（複数回指定可能、最大2枚）-
-o, --output-dir出力ディレクトリ~/Downloads/QoderImages
--prefixファイル名のプレフィックスimage
--no-download送信のみ行い、待機しません-
--task-id既存のタスクを照会します-
--api-keyAPI Key を指定します-

非推奨パラメーター（新しいインターフェースではサポートされません。指定すると無視され、通知が表示されます）

パラメーター説明
--quality代わりに --resolution を使用してください
--format新しいインターフェースでは PNG 固定出力です
--bg / --background新しいインターフェースでは背景の制御に対応していません
--compression新しいインターフェースでは圧縮率の指定に対応していません
--fidelity新しいインターフェースでは忠実度の制御に対応していません
依存関係のインストール
依存関係インストールコマンド
requestspip3 install requests

初回使用時

まず API Key を設定してから、次を実行します：

# 设置环境变量
export REDFOX_API_KEY=ak_你的密钥

# 运行
python3 "$SKILL_PATH/assets/imagegen.py" "一只橘色的猫咪"

redfox.hk にアクセスして登録し、API Key を取得してください。

⚠️ 新しいインターフェースは有料での呼び出しのみに対応しており、アカウントの無料クレジットをこのインターフェースに使用することはできません。エラーコード 3203 が返された場合は、チャージページにアクセスして有料クレジットを追加してください。

以降の使用時

redfox.hk にアクセスしてアカウントを登録し、自分の API Token を取得してください。次の3つの設定方法からいずれかを選択できます：

設定方法説明コマンド
環境変数（推奨）1回設定すれば、全体に適用されますexport REDFOX_API_KEY=ak_あなたのキー
コマンドライン引数一時的に使用し、1回限り有効ですpython3 "$SKILL_PATH/assets/imagegen.py" "prompt" --api-key ak_あなたのキー
設定ファイル永続的に保存され、セッションをまたいで保持されますmkdir -p ~/.qoder/apis && echo '{"api_key":"ak_あなたのキー"}' > ~/.qoder/apis/redfox.json

インターフェース仕様（新）

タスクの送信

POST https://redfox.hk/story/api/parseWork/imageGen/gptImage2Submit

リクエストヘッダー：REDFOX_API_KEY: ak_xxx + Content-Type: application/json

リクエスト本文：

{
  "prompt": "把这个海报的主体变为手表 并把文字都用中文",
  "resolution": "2k",
  "size": "16:9",
  "n": 2,
  "referenceImages": ["https://example.com/poster.jpg"]
}

レスポンス：data.taskId を後続のポーリングに使用します。

結果の照会

POST https://redfox.hk/story/api/parseWork/imageGen/gptImage2Result

リクエスト本文：{"taskId": "..."}

レスポンスの主なフィールド：

フィールド説明
data.statuscompleted / processing / queued / failed
data.progress生成の進行状況（0～100）
data.imageUrls生成結果の URL 配列（数は n と一致）
data.failReason失敗理由（成功時は null）
data.model使用したモデル（gpt-image-2）
data.resolution / data.size実際に使用した段階とアスペクト比

よくある質問

Q：この Skill の特長は何ですか？ A：コマンドラインから gpt-image-2 モデルを直接呼び出し、一括生成、アスペクト比と解像度の段階の制御、画像から画像生成（参考画像は最大2枚）に対応しています。

Q：画像を1枚生成するにはどのくらい時間がかかりますか？ A：通常は10～60秒です。4k の段階や複雑なシーンでは、さらに時間がかかることがあります。スクリプトが自動的にポーリングして待機し、progress を表示します。

Q：新しい resolution と旧 quality の違いは何ですか？ A：resolution は解像度の段階（1k/2k/4k）で、出力画像の鮮明さと生成時間を直接決定します。旧 quality パラメーターは非推奨で、指定しても無視されます。

Q：--size がピクセル指定からアスペクト比指定に変わったのはなぜですか？ A：新しいインターフェースの gptImage2Submit では、size フィールドにアスペクト比（例：16:9）を指定します。旧形式との互換性を保つため、スクリプトは引き続き 1792x1024 などのピクセル形式を受け付け、内部でアスペクト比＋推奨段階に自動変換します。

Q：画像から画像生成では、参考画像を何枚渡せますか？ A：新しいインターフェースでは最大2枚です。--image を複数回指定してください。上限を超えた分は切り捨てられ、その旨が通知されます。

Q：呼び出し時にエラーコード 3203 が返されるのはなぜですか？ A：新しいインターフェースは有料での呼び出しのみ対応しており、アカウントの無料クレジットは使用できません。redfox.hk/dashboard/recharge にアクセスして有料クレジットをチャージしてください。

Q：API Key はどこで取得できますか？ A：redfox.hk にアクセスして登録し、自分の API Token を取得してください。

Q：参考画像としてどの画像形式に対応していますか？ A：PNG、JPEG、WebP 形式のローカルファイルまたは HTTP(S) URL に対応しています。

Q：プロンプトに文字数制限はありますか？ A：プロンプトは最大500文字です。超過すると処理が中断され、短くするよう通知されます。

コメント

Markdown 対応