Skip to content

Codex Relay 接入

推荐流程

  1. 先从运营方或部署方获取当前可用的 API 中继基础地址。
  2. 将 Codex 类客户端的目标地址改为中继入口,而不是上游厂商原始域名。
  3. 使用为当前账号签发的 API Key,并确认它仍在有效期内。
  4. 先发起一次最小请求,确认域名、认证头和模型名都能正常工作。
  5. 验证通过后,再接入 IDE、终端或自动化工具链。

最小验证时建议检查

  • Host 和路径前缀是否与文档一致
  • Authorization 请求头是否正确
  • 所用模型名是否在当前实例支持范围内
  • 返回内容是否正常,或是否出现明确报错

运行建议

  • 优先使用环境变量管理基础地址和 API Key,方便后续轮换。
  • 保留一个体量很小的 smoke test,请求失败时先用它复现。
  • 平台更新后若出现异常,先对比域名、请求头、模型名和超时设置。
  • 如果问题只在某个客户端出现,先排除该客户端自己的代理或缓存配置。

需要联系支持时

如果多次验证后仍无法访问,建议一并提供:

  • 请求发生的大致时间
  • 脱敏后的 Key 标识
  • 使用的客户端或 IDE 名称
  • 请求目标模型
  • 返回的错误信息或截图

Codebyby documentation site.