Skip to content

常用客户端 ​

支持自定义 OpenAI Provider 的客户端通常都可以接入。界面名称可能不同,但核心字段相同。

OpenAI 兼容客户端 ​

适用于 Cherry Studio、Cline、Roo Code、NextChat 和其他支持自定义 OpenAI Endpoint 的软件:

字段推荐值
ProviderOpenAI Compatible / Custom OpenAI
API Key你的 Codex Relay Key
API Basehttps://codexapi.asia/v1
Model/v1/models 返回的准确 ID
Endpoint优先 Responses;不支持时使用 Chat Completions

如果软件会自动追加 /v1,API Base 改为 https://codexapi.asia。最终请求路径只应出现一次 /v1。

配置后如何验证 ​

  1. 关闭客户端内置的官方登录,确保请求使用自定义 Provider。
  2. 刷新模型列表,确认能看到与 /v1/models 一致的模型。
  3. 先发一个不带工具的短文本请求。
  4. 再测试流式、工具调用或图像功能。
  5. 失败时记录 HTTP 状态码和请求 ID,隐藏 API Key 后再提交排查。

软件只显示内置模型

有些客户端不读取服务端模型列表。此时选择“自定义模型”并手动填写准确的模型 ID;如果软件完全不允许自定义模型,则需要更换兼容客户端。