OpenzzAI Codex API 控制台
兑换码
登录后可用。订阅类兑换码成功后会自动激活并生成订阅 Key。
用户资料
登录后可查看和修改基础资料。
我的 API Key
使用说明
本站当前专注 Codex API 服务，采用阶梯式预付余额结算模式。新用户建议先完成充值，再按下方指引接入。
零基础最快上手：先记住这 3 样东西
绝大多数软件只需要填写 接口地址、API Key、模型名 这三项；本站当前专注 Codex API，采用阶梯优惠口径，档位更细，充值越多，到账比例越优。
-
登录后进入「用户资料」→「我的 Key」→ 复制当前 Key
gpt-5.4
如果你还没有余额或 Key，请先进入「充值余额」查看可选档位，并按页面联系方式完成充值。虚拟余额售出不退，请先确认充值档位与使用需求；到账后再进入「兑换码」页面提交兑换。
登录后进入「用户资料」页面，在「我的 Key」里找到当前可用的 Key，点击“复制当前 Key”。后续所有软件都用这把 Key 接入。
如果你只有一台 Windows / Mac 电脑、也不懂命令行，优先选带界面的 OpenAI 兼容客户端。如果你想使用 Codex CLI 或 OpenClaw，也可以继续按下方教程一步一步安装；其中 Node.js 安装完成后会自带 npm，不需要单独再找 npm 安装包。
Provider / API 类型选择 OpenAI 或 OpenAI Compatible；接口地址填写上方 Base URL，API Key 填写你自己的 Key，模型名建议默认使用 gpt-5.4，如需测试新模型可按需选择 gpt-5.5。
配置保存后，先发送一句“你好，请回复测试成功”。如果能正常回复，说明已经接入成功；如果报错，再回来核对 Base URL、Key、模型名有没有填错。
- Provider / API 类型：选 OpenAI 或 OpenAI Compatible。
- Base URL / API Host / Endpoint：填上方接口地址，通常要带上 /v1。
- API Key：填你自己的真实 Key，不要发给别人，也不要截图公开。
- Model / 模型名：先填
gpt-5.4，不行再刷新模型列表后重新选择。 - Organization / Project / Workspace：如果软件要求填写，但你看不懂，先留空。
- WebSocket / Realtime / 自定义 Header：普通用户先不要开，保持默认即可。
按软件接入
先看适合普通用户的图形界面教程；会命令行或需要开发接入时，再看后面的代码示例。
普通用户最推荐：任何支持 OpenAI 接口的桌面客户端（如 Cherry Studio / ChatBox）
适合谁
只有一台电脑、不会命令行、想直接开始聊天或做日常使用的用户。
操作步骤
- 先安装一个支持 OpenAI / OpenAI Compatible 的桌面客户端。
- 打开软件后，进入「设置 / 模型服务 / Provider / API 配置」之类的页面。
- 新增一个自定义提供商，类型选择 OpenAI 或 OpenAI Compatible。
- 接口地址（Base URL）填：
- - API Key 填你在本站「我的 Key」里复制出来的真实 Key。
- 模型名先填：
gpt-5.4 - 保存后，新建一个对话，先发一句测试消息。
通用规则：几乎所有 OpenAI 兼容软件都只需要填这三项
- 接口地址：
- - API Key：你自己的真实 Key
- 模型名：
gpt-5.4
- 如果软件能“获取模型列表”，先点一次获取；获取不到时，手动输入
gpt-5.4也可以。 - 如果你复制的 Key 接入失败，先回本站「查询」页验证这把 Key 是否仍然可用。
- 如果软件只认 OpenAI API，不认别的名字，就选 OpenAI，不要选 Anthropic / Gemini / Azure。
常见报错排查：遇到问题先看这里
1. 提示 401 / Invalid API Key / API Key 无效
- 先确认你填的是真实 API Key，不是示例里的“这里输入你的 API Key”。
- 重新复制一次本站「用户资料」里的当前 Key，粘贴时不要多复制空格、换行或引号。
- 如果还是不行，先回本站「查询」页，用这把 Key 查一下；查不到说明 Key 本身有问题。
2. 提示 404 / model not found / 模型不存在
- 先把模型名改成：
gpt-5.4 - 确认接口地址填写的是：
- - 很多软件要求接口地址必须带
/v1，少了这一段就容易报 404。
3. 提示连不上 / timeout / network error
- 先检查你的电脑网络是否正常，是否开了会拦截软件联网的代理、防火墙或安全软件。
- 先不要开启 WebSocket、Realtime、Streaming 增强之类的高级选项，保持默认。
- 如果你是在公司网络、校园网或特殊代理环境下使用，建议先切到普通家庭网络再试一次。
4. 软件里要求填 Organization / Project / Workspace
- 如果你看不懂这些字段，先留空。
- 普通用户通常只需要填写 Base URL、API Key、模型名三项。
5. Codex CLI / OpenCode / OpenClaw 配置后没生效
- 先确认配置文件保存到了正确路径。
- 确认把示例里的 Key 改成了你自己的真实 Key。
- 保存后重新打开终端、客户端或软件，再重新测试一次。
6. 如果还是不会排查，联系前先准备这些信息
- 你用的软件名字（例如 Cherry Studio、ChatBox、Codex CLI）
- 你填写的模型名
- 报错原文或完整截图
- 你的 Key 在本站「查询」页是否能查到
Codex CLI 安装与接入教程
以下步骤按 Windows 电脑整理；Mac 或 Linux 的路径不同，但思路相同。Codex CLI 是在终端中使用的软件，不是网页聊天框。
第 1 步：安装 Node.js
- 打开官网
https://nodejs.org/ - 下载安装 Node.js LTS 版本
- 安装完成后，重新打开 PowerShell
- 输入
node -v，能显示版本号再继续
第 2 步：安装 Codex CLI
- 打开 PowerShell
- 有代理时输入：
npm install -g @openai/codex - 如果你没有代理，直接输入：
npm install -g @openai/codex --registry=https://registry.npmmirror.com - 安装完成后，输入
codex --version，能显示版本号说明安装成功
第 3 步：准备配置文件
- 打开文件资源管理器
- 进入你的用户目录，例如：
C:\Users\你的用户名 - 如果没有
.codex文件夹，请手动新建一个 - 在这个文件夹里新建
config.toml和auth.json两个文件
第 4 步：复制并填写配置
- 把上面的内容复制到对应文件中
- 把
这里输入你的API Key改成你自己的真实 Key - 保存文件后，关闭 PowerShell 再重新打开
第 5 步：开始使用
- 在 PowerShell 中进入你的项目目录，例如：
cd D:\project - 输入：
codex - 启动后，你就可以直接输入需求，例如“帮我看看这个项目怎么启动”
Codex CLI（WebSocket）配置示例
这一版只适用于你已经确认本地 Codex CLI 需要使用 WebSocket 模式的情况。大多数普通用户不需要使用这一版。
OpenClaw 安装与接入教程
以下步骤同样按 Windows 电脑整理。OpenClaw 适合希望在本地持续使用助手、并通过配置文件接入模型的用户。
第 1 步：安装 Node.js
- 如果你前面已经为 Codex CLI 安装过 Node.js，这一步可以跳过
- 如未安装，请先到
https://nodejs.org/安装 Node.js LTS
第 2 步：安装 OpenClaw
- 打开 PowerShell
- 有代理时输入：
npm install -g openclaw - 如果你没有代理，直接输入：
npm install -g openclaw --registry=https://registry.npmmirror.com - 安装完成后，输入
openclaw --version检查是否安装成功
第 3 步：找到配置文件
- 进入你的用户目录，例如：
C:\Users\你的用户名 - 如果找不到
.openclaw文件夹，请先在 PowerShell 里执行：openclaw setup - 执行完成后，再回到用户目录查看
.openclaw文件夹 - 在该目录中找到或新建
openclaw.json文件
第 4 步：复制并填写配置
- 把示例整体复制进去
- 把里面的
apiKey改成你自己的真实 Key - 保存文件
第 5 步：启动并检查
- 重新打开 PowerShell
- 输入：
openclaw status - 如果没有明显报错，说明已经接入成功
OpenCode 配置示例
配置文件路径：~/.config/opencode/opencode.json（或 opencode.jsonc）。如目录不存在，请先手动创建。API Key 可直接写入，也可通过客户端 /connect 命令配置。
开发测试示例：Python / curl
Python OpenAI SDK
curl 示例
充值余额
本站当前专注 Codex API 服务，采用阶梯式预付余额结算模式；请先阅读价格说明，再通过下方微信完成充值。
2. 充值金额越高，到账比例越优惠；当前参考档位已扩展为：¥10 到账 $15、¥20 到账 $32、¥30 到账 $52、¥50 到账 $95、¥100 到账 $220、¥200 到账 $580、¥300 到账 $1000。
3. 当前最高档位的展示口径低至 0.3 RMB = 1 USD，其余档位按阶梯比例到账。
4. 余额到账后按实际调用量扣费，适用于 Codex / OpenAI Compatible 客户端接入及 API 调用场景。
5. 本站提供的为虚拟 API 余额与虚拟服务，售出不退；余额到账后不支持退款、折现、转让或拆分，请在充值前确认档位、用途与接入方式。
2. 充值成功并到账后，默认视为已交付完成，售出不退。
3. 如因本站自身故障导致长期无法提供服务，将按未消耗部分另行协商处理。
4. 如你不确定是否适合自己的软件或使用场景，请先咨询，再决定是否充值。
Codex API 充值咨询
如需充值 Codex 余额，请直接添加下方微信联系。
你可以备注计划充值的金额、主要使用场景或准备接入的软件，我们会尽快回复并协助开通。
