账户与 API Key

API Key 用于识别调用者、分组、计费规则和并发限制。一个 Key 只能看到其所属分组公开的模型。

创建 Key

1. 登录 Codex Relay 控制台。
2. 打开 API Key 页面并选择 新建。
3. 填写一个能区分用途的名称，例如 macbook-codex 或 server-bot。
4. 选择分组。分组决定可见的 OpenAI 模型、倍率和调度池。
5. 如有需要，设置到期时间、余额或模型限制。
6. 创建后立即保存完整 Key。

不要公开 API Key

不要把真实 Key 写进网页 JavaScript、Git 仓库、截图或教程。本文所有示例都使用 YOUR_API_KEY 占位符。

验证 Key

curl -i https://codexapi.asia/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

返回 200 且包含模型列表，说明域名、TLS、Key 和分组均可用。

认证方式

场景	推荐请求头
OpenAI SDK、Codex 与通用客户端	Authorization: Bearer YOUR_API_KEY

不建议把 Key 放在查询参数中。日志、浏览器历史和代理层更容易记录完整 URL。

多个客户端如何分配

建议按设备或业务拆分 Key：

• Codex、OpenAI SDK、桌面客户端和服务器任务分别使用不同 Key。
• 测试环境和生产环境分别使用不同 Key。
• 临时分享时创建低额度、短有效期 Key，用完立即删除。
• 出现异常消耗时，只吊销受影响的 Key，不必更换全部客户端。

余额、订阅与用量

控制台会显示余额、订阅进度和调用记录。请求能否执行还取决于 Key 状态、用户状态、分组可用性、订阅额度与并发限制。只剩余额并不代表任意模型都一定可用。

Key 泄露后的处理

1. 立即禁用或删除旧 Key。
2. 创建新 Key，并只更新受影响的客户端。
3. 检查调用记录中的时间、模型、Token 和来源 IP。
4. 如有异常消耗，联系站点管理员并提供请求 ID，不要发送完整 Key。