SuperAPI AI 工具集

codex-image-gen

设计与创作

查看项目

更新于 10-16 06:52

技能介绍

用途:把本机已登录的 Codex OAuth 生图能力封装成零私有依赖的跨 Agent Skill。任何能执行 python3 的 Agent,只要宿主机装好 Codex CLI 并执行过 codex auth login,即可调用 scripts/codex_image.py 生图或做图像编辑。

前置条件:本机已安装 Codex CLI;已执行 codex auth login;~/.codex/auth.json 存在且可读;机器可访问 https://chatgpt.com/backend-api/codex/responses 与 https://auth.openai.com/oauth/token。若 auth.json 不存在,应提示用户先运行 codex auth login,不要猜测或绕过。

主要能力:文生图、配图/插图/封面图生成、image-to-image 与编辑(把本地参考图编码为 data:image/...;base64,... 后发给 Codex Responses API);自动检查 access token 是否过期,过期时用 refresh token 刷新并写回 ~/.codex/auth.json;从 SSE 流提取图片 base64 并保存为本地 PNG。

使用方式:核心脚本为 scripts/codex_image.py。典型调用:python3 scripts/codex_image.py --prompt "极简科技感课程封面,无文字" --aspect landscape。若不在 skill 根目录执行,需显式传相对或绝对路径。CLI 参数:必填二选一 --prompt 或 --prompt-file;可选 --quality low|medium|high(默认 medium)、--aspect landscape|square|portrait(默认 square)、--out-dir(默认当前目录)、--image(主编辑图)、--reference-image(参考图,可重复)、--model(默认 gpt-image-2)。成功时输出 JSON:{"success": true, "image": "/absolute/path/to/file.png"}。

适用场景:为课程、文章、海报等生成封面或配图,头像、图标、方图,以及基于草图或参考图的风格化编辑。

限制与失败处理:401 表示本地登录态失效,建议重新 codex auth login;403 大概率是 Cloudflare、关键请求头或账号态问题,需检查 User-Agent: codex_cli_rs/0.0.0、originator: codex_cli_rs、ChatGPT-Account-ID;未拿到图片数据说明上游 SSE 响应格式变化,应检查 references/api-notes.md 并更新脚本。API 细节见 references/api-notes.md。