工具配置
使用 Codex Skill 生成图片
了解在使用 GetToken 中转服务时,如何通过 imagegen-compatible Skill 完成 Codex 图片生成。
使用 GetToken 中转服务时,Codex 不能直接通过客户端内置 ImageGen 生成图片。
原因是:内置 ImageGen 需要可直连 OpenAI Images API 的 Key;GetToken 提供的是中转服务 API Key,不接管 Codex 内置 ImageGen 的直连链路。
因此,使用本站中转服务进行图片生成时,必须使用 imagegen-compatible Skill。
让 Codex 安装
推荐直接把下面这段发给 Codex:
请帮我安装这个 Codex skill:https://cnb.cool/youidian/imagegen-compatible
要求:
1. 将仓库克隆到 ${CODEX_HOME:-$HOME/.codex}/skills/imagegen-compatible。
2. 安装前检查目标目录是否已存在;如果已存在,请先询问我是更新、覆盖还是跳过,不要直接删除。
3. 安装后确认 SKILL.md、scripts/image_gen.py、agents/openai.yaml、references/config.md 都存在。
4. 如果本机有 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py,请运行它验证这个 skill。
5. 最后提醒我重启 Codex。
安装完成后,重启 Codex。
使用要求
在 Codex 中生成图片时,生图任务必须交给 imagegen-compatible 处理。
不要使用:
- Codex 客户端内置 ImageGen
- 依赖 OpenAI 官方直连 Key 的生图方式
应使用:
imagegen-compatibleSkill- GetToken API Key
- OpenAI-compatible Images API 地址
配置接口
imagegen-compatible 读取两个环境变量:
OPENAI_API_KEY
OPENAI_BASE_URL
macOS / Linux:
export OPENAI_API_KEY="<你的 GetToken API Key>"
export OPENAI_BASE_URL="https://api.gettoken.dev/v1"
Windows PowerShell:
$env:OPENAI_API_KEY = "<你的 GetToken API Key>"
$env:OPENAI_BASE_URL = "https://api.gettoken.dev/v1"
不要把真实 API Key 写入公开仓库或公开截图。
安装位置
Skill 必须安装到 Codex 实际运行环境的 .codex/skills 目录。
macOS / Linux:
${CODEX_HOME:-$HOME/.codex}/skills/imagegen-compatible
Windows PowerShell:
$env:USERPROFILE\.codex\skills\imagegen-compatible
Windows WSL:
~/.codex/skills/imagegen-compatible
如果 Codex 运行在 WSL,就安装到 WSL 环境里;如果 Codex 运行在 Windows 原生环境,就安装到 Windows 用户目录下。
常见问题
为什么不能直接用内置 ImageGen
Codex 内置 ImageGen 需要直连 OpenAI Images API 的 Key。使用 GetToken 中转服务时,这条直连链路无法工作,所以需要由 imagegen-compatible 接管图片生成。
Codex 找不到 Skill
确认 Skill 安装在 Codex 实际运行环境的 .codex/skills 目录下,然后重启 Codex。
Windows 安装后不可用
确认 Codex 是运行在 Windows 原生环境还是 WSL。Skill 必须安装到同一个环境。
生成失败
优先检查:
OPENAI_API_KEY是否正确。OPENAI_BASE_URL是否包含/v1。- 当前接口是否支持 Images API。
- 输出目录是否存在或有写入权限。