返回 Skill 列表

openai-compatible-imagegen 图标

openai-compatible-imagegen

接入你自己的 OpenAI 兼容图片 API，在 Agent 里完成文生图、参考图编辑、JSONL 批量生成、透明底素材和尺寸/Alpha 质检，密钥只留在本地

code-generation图片生成gpt-image批量生图

场景示例

「生成一张 16:9、2K 的新品发布横幅，再输出一张 1200x675 的 PNG」——生成后自动缩放交付
「做一个居中的火焰宝珠游戏道具，透明底」——透明素材，并检查 Alpha 通道和边缘
「保留笔记本不动，把马克杯换个颜色」——参考图编辑 / 局部修改
「一次生成四张文章配图，保留批量生成清单（manifest）」——JSONL 批量、限流并发，过程可追溯

两种安装形态

Claude Code 等 Agent 客户端：Standalone Skill，调用包内 CLI 生图，汇报输出文件和 manifest 路径
Codex App：推荐 Plugin 形态，多了结果卡片、画布标注编辑和版本历史；装完需完全退出并重启 Codex

首次配置（Standalone 必做）

Skill 从安装目录下的 auth.json 读取配置，没有这个文件就无法生图：

bash
python3 ~/.claude/skills/openai-compatible-imagegen/scripts/quick-init.py   # 配置向导
python3 ~/.claude/skills/openai-compatible-imagegen/scripts/imagegen.py info  # 查看脱敏后的配置

关键字段：protocol（一般填 openai-compatible）、base_url（以 /v1 结尾）、model（如 gpt-image-2）、api_key_env（存密钥的环境变量名，比明文 api_key 更推荐）。

Codex Plugin 的配置在 ~/.codex/openai-compatible-imagegen/config.json，直接在会话里让 Codex 帮你初始化即可，密钥值不要发进对话。

后端需要提供 POST /v1/images/generations（编辑功能还需要 /v1/images/edits），返回 data[].b64_json 或 data[].url。

避坑清单

需要 Python 3.12+，版本过低无法运行；Plugin 形态另需 Node.js 20+
不要重复执行 skills add 来"更新"：会覆盖安装目录，把 auth.json 一起删掉；更新方法是下载新版 ZIP、把 auth.json 复制过去，再运行 info 验证
不要把密钥贴进对话，优先用环境变量
透明底取决于服务商：服务不支持 background=transparent 时，改走本地抠图路线（chroma-matting）
生成的图片和清单不要放在 Skill 目录里，更新时会被一起删掉
装完重启会话