GetToken 文档

GetToken 使用说明

从购买充值套餐到查看 API Key,再到接入常用工具和图片生成 Skill,这里按步骤说明。

查看我的 API Key

登录后可直接查看当前账号的 GetToken API Key,再复制到 Codex 或 OpenCode 配置里。

工具配置

使用 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:

text
请帮我安装这个 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-compatible Skill
  • GetToken API Key
  • OpenAI-compatible Images API 地址

配置接口

imagegen-compatible 读取两个环境变量:

text
OPENAI_API_KEY
OPENAI_BASE_URL

macOS / Linux:

bash
export OPENAI_API_KEY="<你的 GetToken API Key>"
export OPENAI_BASE_URL="https://api.gettoken.dev/v1"

Windows PowerShell:

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:

text
${CODEX_HOME:-$HOME/.codex}/skills/imagegen-compatible

Windows PowerShell:

text
$env:USERPROFILE\.codex\skills\imagegen-compatible

Windows WSL:

text
~/.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 必须安装到同一个环境。

生成失败

优先检查:

  1. OPENAI_API_KEY 是否正确。
  2. OPENAI_BASE_URL 是否包含 /v1
  3. 当前接口是否支持 Images API。
  4. 输出目录是否存在或有写入权限。