base_url 到底该填什么：四类客户端的中转接入对照

很多人在中转站接入失败，问题并不在 Key，而在 base_url 少写或多写了一层路径。OpenAI 官方 SDK 需要的是以 /v1 结尾的地址，例如 https://example.com/v1，SDK 会自己拼接 /chat/completions。如果把首页地址直接粘进去，请求就会打到 https://example.com/chat/completions，返回 404 或一段 HTML。

Anthropic SDK 的差异在于路径前缀是 /v1/messages，且鉴权头是 x-api-key 而不是 Authorization。部分中转站同时兼容两种头，但不要依赖这种宽容：先用官方 SDK 默认行为跑通，再考虑改成统一封装。若站点只声明 openai 协议，那么 Anthropic 客户端需要显式配置兼容端点，否则会一直收到 401。

桌面客户端（Cherry Studio、Chatbox 一类）通常把 base_url 与模型名分开填写，容易出错的是模型名。中转站往往给模型起了别名，例如把 gpt-6-astra 写成 GPT-6-Astra。别名大小写不敏感的实现占多数，但也有站点严格匹配，此时应直接复制站点模型列表里的原始字符串。

用 cURL 验证是最快的一步：先发一次 /models 列表请求确认鉴权通过，再发一次最小 chat 请求确认路由可用。两次请求都成功，才说明 base_url、Key 与模型名三者一致。这个顺序能避免在客户端里反复猜测设置项。

最后建议把可用配置写进项目文档：base_url、默认模型、超时时间、重试次数四项固定下来，团队里换人时不必重新摸索。配置漂移是多中转混用场景下最常见的事故来源。