测一家
首页/故障案例/curl 能通,SDK 报 404
CASE / 接入

curl 能通,SDK 报 404

同一个 Key、同一个模型,用 curl 请求成功,换成官方 SDK 后稳定 404。

症状模式可复现步骤证据优先

这个症状不能证明什么

先排除误判

404 不一定是站点没有这个接口,多数时候是 SDK 自己拼了路径或加了版本段。

按这个顺序验证

4 STEPS
  1. 打开 SDK 的 debug 日志,看它实际请求的完整 URL。
  2. 对比 curl 的 URL:差别通常在 /v1、/v1beta 或结尾斜杠。
  3. 确认 base_url 的写法:有些 SDK 需要写到域名,有些需要写到 /v1。
  4. 如果是 Anthropic SDK,确认有没有带 anthropic-version 头。

什么证据才算数

EVIDENCE

SDK debug 日志里的完整 URL、curl 的完整 URL、两者的请求头差异。

结论怎么写

CONCLUSION

URL 能对上但依然 404,才是站点侧的问题;URL 对不上就是客户端配置。

接下来做什么

ACTION

把 base_url 固定成文档里写的形式,用环境变量注入,不要在代码里二次拼接。

案例是症状模式,不是对任何具体站点的结论。写报告时请引用你记录到的请求 ID、时间戳和响应原文,不要引用本页。