开通并配置 OpenAI API
最后核对:2026-09-20。 OpenAI 的注册要求、最低充值金额、模型和套餐会变化,请以本文链接的官方页面及账号实际显示为准。
Codex 支持使用 ChatGPT 账号登录,也支持 OpenAI API Key。这是两条不同的使用和计费路径。
先选适合你的方式
Section titled “先选适合你的方式”| 你的情况 | 建议方式 |
|---|---|
| ChatGPT 方案中已经包含 Codex 权益 | 使用 ChatGPT 账号登录 Codex |
| 希望按 API 实际用量付费 | 开通 OpenAI API Platform |
| 希望在 EasyAI 统一管理多个模型服务 | 创建 Project API Key |
方式一:用 ChatGPT 账号登录 Codex
Section titled “方式一:用 ChatGPT 账号登录 Codex”- 使用 EasyAI 安装 Codex。
- 启动 Codex,选择官方 ChatGPT 登录。
- 在浏览器打开的 OpenAI 页面完成登录和授权。
- 返回 Codex 开始使用。
这条路线使用 ChatGPT 方案中包含的 Codex 权益,不使用 API Platform 的 Key 或余额。可用方案和权益会变化,登录前查看 Codex 官方认证说明。
方式二:开通 OpenAI API
Section titled “方式二:开通 OpenAI API”1. 确认地区与注册账号
Section titled “1. 确认地区与注册账号”先查看 OpenAI API 支持的国家和地区。然后打开 OpenAI Platform 注册或登录。
邮箱、手机号、组织或身份验证要求会因地区、账号和模型权限变化,以页面实际提示为准。
2. 设置 API 计费
Section titled “2. 设置 API 计费”打开 API Billing Overview,选择 Add payment details,按页面提示添加付款方式和 API Credits。
账号可能显示预付 Credits、自动充值或其他结算选项。可用方式、最低金额、币种和余额规则会因账号与地区变化,付款前以 Billing 页面实际显示为准。
付款后余额同步可能需要几分钟。
3. 建立独立 Project
Section titled “3. 建立独立 Project”建议为 EasyAI 建立独立 Project,便于控制模型权限和支出:
- 打开 Projects。
- 切换到正确的 Organization。
- Organization Owner 选择 Create project。
- 命名为
EasyAI或你容易识别的名称。 - 为 Project 设置合适的模型与支出限制。
如果页面不显示创建入口,请确认自己位于正确的 Organization,并让 Organization Owner 检查你的角色和 Project 权限。
4. 创建 Project API Key
Section titled “4. 创建 Project API Key”- 打开 API Keys。
- 确认页面当前选择的是刚才的 Project。
- 选择 Create new secret key。
- 第一次配置排错可使用
All权限;熟悉后可以改为Restricted并只开放所需接口。 - 创建后立即保存完整密钥。
完整 Secret 只显示一次。不要把 Key 发给客服、群聊或提交到 Git;泄露后立即删除旧 Key 并创建新 Key。
在 EasyAI 中怎么填
Section titled “在 EasyAI 中怎么填”打开 AI Agents → Codex → 配置 API → 添加服务商:
| 字段 | 填写内容 |
|---|---|
| 服务商名称 | OpenAI 官方 API |
| API 类型 | OpenAI Responses |
| Base URL | https://api.openai.com/v1 |
| API Key | Platform 创建的完整 Project API Key |
| 默认模型 | 当前账号和 Project 可使用的准确模型 ID |
| 启用此服务商 | 开启 |
新配置首选 OpenAI Responses。只有工具明确要求旧接口时才选择 OpenAI Chat Completions。OpenAI 的说明见 迁移到 Responses API。
保存后选择 配置生效,再执行 重新检测。检测可用后新建 Codex 会话。
模型应该填什么
Section titled “模型应该填什么”模型字段需要填写 API 模型 ID,不是 ChatGPT Plus、GPT Pro 之类的套餐名称,也不一定等于 ChatGPT 网页中的展示名称。
- 打开 OpenAI API 模型目录。
- 如果用于 Codex,再查看 Codex 模型选择。
- 确认当前 Project 的 Limits / Model Usage 允许该模型。
- 将准确模型 ID 填入 EasyAI。
模型会持续发布和调整,因此本文不把某一个模型写成永久默认值。
已经购买 ChatGPT Plus,但提示 API 没有余额
ChatGPT 与 API 分开计费。进入 API Billing 添加付款方式和 Credits。
credit_balance_exhausted
预付余额已用完。购买更多 Credits,等待余额同步后再试。
organization_usage_limit_exceeded / organization_spend_limit_exceeded
组织的月度批准额度或硬性支出限制已达到。由 Organization Owner 检查 Billing 与 Limits。
project_spend_limit_exceeded
当前 Project 的支出上限已达到。检查 Project 设置,而不只是组织总余额。
余额正常,但模型不可用
检查 Key 是否属于当前 Project、账号是否是 Project Member、Project 是否允许该模型,以及 Restricted Key 是否开放读取模型和调用 Responses 接口。部分模型或更高用量层级可能要求额外验证,以 Platform 页面显示为准。
429 错误
429 不一定表示余额不足,也可能达到请求或 Token 速率限制。不要持续快速重试,先查看 Rate limits 官方指南 和 Organization Limits。