为什么我调通了 OpenAI SDK,Claude 的客户端却一直 404
同一个 Base URL、同一把 Key,OpenAI SDK 一切正常,换成 Claude 系客户端就稳定 404。这类问题的根源几乎总是同一个:Anthropic 生态的客户端有自己的地址约定,而多数教程只覆盖了 OpenAI 那一半。
Anthropic 的地址约定:Base URL 不带 /v1
Anthropic 官方 SDK 的 base_url 默认是 https://api.anthropic.com,不带 /v1,SDK 自己拼 /v1/messages。所以 Anthropic 侧应该填 https://aiminis.info,OpenAI 侧才填 https://aiminis.info/v1。
Anthropic 生态的客户端最舒服的一点,是它们约定了一个不带 /v1 的 Base URL。
在 Claude Code 里配置 ANTHROPIC_BASE_URL=https://aiminis.info、再填上 ANTHROPIC_AUTH_TOKEN,工具链就能直接跑起来,不需要改任何 SDK 代码。
一个网关两条路径,能力集并不完全相同
同一个模型,走 /v1/chat/completions 和走 /v1/messages 能用到的参数并不一样。跨协议转换时丢掉的部分必须由网关明确告知,而不是让用户撞上 invalid_request 才发现。
接入一个 OpenAI 兼容网关,实际要认的就三条主线:/v1/chat/completions、/v1/responses、/v1/models。
第一条是经典对话补全,第二条是新一代 Responses 接口(带状态、工具、内建能力的统一入口),第三条决定了你能不能枚举出可用的模型。
把 Base URL 做成配置项的意义
两套地址约定意味着你的工程里至少有两个 Base URL 变量。它们都应该是配置,而不是散落在代码里的字面量——换供应商、灰度、灾备的时候,这个差别会变得非常明显。
OpenAI 官方 SDK 里,base_url 是「前缀」,不是「完整地址」。
哪怕只有一个后端,也建议把 Base URL 抽成环境变量或配置中心的一项。
404 先看路径,再看权限
404 有两种来源:路径拼错(网关根本没有这个路由)和模型不在你的授权池里(路由存在但直接拒绝)。先确认路径对不对,再去查 /v1/models 里有没有这个模型。
401 是「你的凭据没通过验证」,403 是「凭据没问题但你不被允许」。
对应到网关:401 多半是 Key 本身错误、过期或被撤销;403 多半是分组不允许访问目标模型,或者上游凭据失败。
实操:Anthropic 协议入口:注意 base 里没有 /v1。
直接对比一下两个协议入口的请求格式,差异会比文档描述得更直观。
curl "https://aiminis.info/v1/messages" \
-H "x-api-key: sk-gw-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'
# 注意 Anthropic 侧的 Base URL 约定:
# ANTHROPIC_BASE_URL=https://aiminis.info (不加 /v1)
# OpenAI 侧的 base_url=https://aiminis.info/v1
几个容易踩的坑
- Anthropic 侧 Base URL 多加了
/v1,请求路径变成/v1/v1/messages。 - 客户端版本读的是
ANTHROPIC_API_KEY,你只设了ANTHROPIC_AUTH_TOKEN。 - 在不支持
temperature的通道上一直传它,结果报参数错误。 - 以为
count_tokens返回的是模型原生 tokenizer 结果,其实可能是本地估算。
小结
先跑通最小请求,再逐项加功能——这是接入任何网关都适用的节奏。
上面提到的能力基本都来自 https://aiminis.info/ 这个自建的 API 网关,支持 OpenAI 与 Anthropic 双协议接入,还有公开的模型健康看板 https://aiminis.info/model-health 可以先看看状态。
- 点赞
- 收藏
- 关注作者
评论(0)