为什么我调通了 OpenAI SDK,Claude 的客户端却一直 404

举报
Rolle 发表于 2026/11/15 17:29:00 2026/11/15
【摘要】 同一个 Base URL、同一把 Key,OpenAI SDK 一切正常,换成 Claude 系客户端就稳定 404。这类问题的根源几乎总是同一个:Anthropic 生态的客户端有自己的地址约定,而多数教程只覆盖了 OpenAI 那一半。

同一个 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 可以先看看状态。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。