Sub2API GPT Image Skill

这是一个用于 Codex 的图像生成 / 图像编辑 skill，面向兼容 OpenAI API 的 sub2api 类中转服务。

主要能力

• 通过 Responses API 调用 GPT Image 生成图片。
• 支持单图、多图参考编辑。
• 支持 mask 局部编辑，使用带 alpha 通道的 RGBA PNG mask。
• 支持批量生成、多方案测试、dry-run、运行日志和结果尺寸校验。
• 支持读取 Codex 的 ~/.codex/config.toml 和 ~/.codex/auth.json，避免在项目里保存 API key。
• 内置 OpenAI 图像文档整理、提示词规范、提示词模板库和原始 prompt catalog。

基本用法

在 Codex 中触发 skill：

使用 $sub2api-gpt-image 生成一张图片……

或在项目中直接调用脚本：

python3 scripts/sub2api_gpt_image.py responses-generate \
  --prompt "一张白底蓝色圆形图标" \
  --size 1024x1024 \
  --quality medium \
  --out outputs/test.png

图像编辑示例：

python3 scripts/sub2api_gpt_image.py responses-edit \
  --image base.png --image-role "Image 1 / edit target" \
  --prompt "只修改局部目标，保持其他区域不变" \
  --size 1024x1024 \
  --quality medium \
  --out outputs/edit.png

mask 编辑示例：

python3 scripts/sub2api_gpt_image.py create-mask \
  --image base.png \
  --shape ellipse \
  --box 200,180,520,460 \
  --out mask.png

python3 scripts/sub2api_gpt_image.py responses-edit \
  --image base.png --image-role "Image 1 / edit target / mask target" \
  --mask mask.png \
  --prompt "只重绘 mask 透明区域，保留不透明区域" \
  --out outputs/masked-edit.png

注意事项

• 不要把 API key 写入仓库或项目文件。
• sub2api 类中转服务的能力可能与 OpenAI 官方 API 不完全一致，建议先用 doctor、--dry-run 和小图测试确认。
• 如果实际输出尺寸与请求尺寸不一致，应视为 provider / relay 限制或执行失败，不要默认为可收纳结果。
• 多参考图编辑时，务必给每张图写清楚角色，并使用 --image-role 绑定输入顺序。

结构

• SKILL.md：Codex skill 主说明。
• scripts/sub2api_gpt_image.py：命令入口。
• scripts/sub2api_gpt_image_main.py：主实现。
• references/usage.md：命令和排错说明。
• references/prompting.md：提示词与编辑策略。
• references/openai-image-docs.md：OpenAI 图像相关文档摘要。
• references/prompt-template-library.md：提示词模板索引。