把现有 OpenAI SDK 接到兼容网关时，最常见的改动是 Base URL。看起来只是替换一个地址，但很多 404、重复路径和认证错误都发生在这里。

Base URL 与完整接口地址

MoonGPT 的 OpenAI 兼容基础地址是：

https://api.moongpt.icu/v1

Chat Completions 的完整地址则是：

https://api.moongpt.icu/v1/chat/completions

多数 SDK 会在 Base URL 后自动拼接 chat/completions。因此配置 SDK 时使用基础地址；手写 curl 时使用完整接口地址。

避免重复的 /v1

如果 SDK 本身已经固定追加 /v1，而你又在配置中加入 /v1，最终可能出现 /v1/v1/...。遇到 404 时，先打印最终请求 URL，而不是立刻更换模型名。

Bearer 认证

OpenAI 兼容入口通常使用以下请求头：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

真实 Key 应来自 控制台，并只保存在服务端环境变量中。

最小化验证顺序

建议按以下顺序排查：

  1. 使用 curl 验证 API Key 与模型名；
  2. 使用 SDK 发起同样的非流式请求；
  3. 再开启 stream；
  4. 最后加入工具调用或结构化输出。

每一步只增加一个变量，问题会更容易定位。