Codex 接入 /v1/chat/completions 教程：小白也能看懂的配置指南

最近看到不少手里有 API 资源，但不知道怎么在客户端里顺利“跑”起来的朋友。特别是手头有了 Codex 相关的 API Key，却卡在了配置 /v1/chat/completions 接口这一步。其实这事儿不难，只要理清了几个关键参数，谁都能顺手配置好。今天就来手把手教大家怎么搞定这个“拦路虎”，顺便聊聊如何利用中转服务让连接更稳定。

一、搞懂接口和端点的区别

很多人配置不成功，主要是混淆了“接口路径”和“基础端点（Base URL）”。

理解接口路径与基础端点的区别，是配置成功的关键

• 接口路径：通常是我们熟知的 /v1/chat/completions，这是标准的 OpenAI 格式路径。在大多数客户端（如 NextChat、LobeChat 等）中，这一项往往不需要手动填写，或者只需保持默认即可。
• 基础端点：这才是配置的核心。它是指 API 服务的根地址。比如官方的地址是 https://api.openai.com，而如果你使用的是第三方服务或者中转，这个地址就会变成对方的域名，比如 https://api.example.com。

重点：不要把完整的 URL（包含 /v1/...）填到 Base URL 里。Base URL 只要填到域名或者端口结束即可，客户端会自动拼接后面的路径。

二、Codex 接入的具体配置步骤

假设你已经拿到了 API Key，下面是通用的配置逻辑：

1. 找到设置入口：在你的客户端软件中，找到“设置”或“API 配置”区域。
2. 填写 API Key：将你获取到的 Key 粘贴到“API Key”输入框中。这是你的身份凭证，千万别泄露给外人。
3. 设置 Endpoint (Base URL)：这是关键一步。如果你直接连接 Codex 的源站，请填写官方提供的服务地址。如果是通过第三方（比如大家常提到的薄荷大佬的 API），则填写对方提供的服务域名。
   • 正确示范：https://api.mint.example
   • 错误示范：https://api.mint.example/v1/chat/completions
4. 模型名称：在模型选择栏，输入或选择该 API 支持的模型代号（通常 Key 提供商会告知具体名称，比如 gpt-4 或自定义名称）。
5. 保存并测试：点击保存后，发送一条简单的“你好”进行测试。如果返回正确回复，说明配置成功。

在客户端设置中填写 API Key 和 Base URL

三、进阶技巧：利用 Sub2 进行中转

有些时候，直连 API 可能会遇到网络不稳定或者访问受限的问题，这时候“中转”就派上用场了。原文提到的 Sub2 是一种常见的解决方案。

• 什么是中转？ 简单说，就是你的请求不直接发给最终的服务器，而是先发给一个中间服务器（中转节点），由它帮你转发给目标 API，再把结果回传给你。

• 如何配置中转？ 对于用户来说，配置中转非常简单，通常只需要修改 Base URL 即可。 将原本的源站地址替换为中转服务的地址。例如，如果你的中转地址是 https://sub2.example.com，那么在客户端的 Base URL 处填入这个地址。

• 中转的好处：

  1. 网络优化：中转服务器通常部署在网络环境更好的节点，能解决直连延迟高或连接中断的问题。
  2. 聚合管理：如果你有多个不同源的 Key，中转服务有时能帮你统一入口。

四、遇到问题怎么办？

如果按照上面配置完了还是报错，可以对照以下几个常见原因排查：

1. 401 Unauthorized：通常是 API Key 填错了，或者 Key 已过期/失效，请检查复制时是否多了空格。
2. 404 Not Found：九成是 Base URL 填错了，比如多填了路径，或者域名拼写错误。请确保只填写域名部分。
3. 超时/连接失败：检查网络环境，或者尝试启用上文提到的 Sub2 中转服务。
4. 模型不存在：检查模型名称是否拼写正确，或者确认该 Key 是否有权限调用此模型。

总之，API 配置就是一场“填空题”，只要把 Key 和 Base URL 这两个核心要素填对，剩下的就交给客户端去处理了。希望这篇教程能帮你省去摸索的时间，赶紧去试试吧！