API 404 报错：Base URL 与 /v1 路径填错怎么解决

调用返回 404，最常见的原因不是服务出了问题，而是 Base URL 写错了：多写或少写了 /v1，或者在 Base URL 后面重复加了接口路径。下面按症状逐项排查。

先区分两种 404

响应内容	原因	去哪看
错误里有 `model_not_found`	路径是对的，但模型 ID 不在当前分组	model_not_found
没有模型相关信息，或返回网页 HTML	请求路径错了	本页

Claude Code 和 Anthropic SDK 会自己拼接 /v1/messages。Base URL 应该是：

https://hrouter.net

如果写成 https://hrouter.net/v1，实际请求就是 /v1/v1/messages，返回 404。

Codex、Cherry Studio、OpenAI SDK 拼接的是 /chat/completions 或 /responses，Base URL 必须自带 /v1：

https://hrouter.net/v1

如果只写 https://hrouter.net，实际请求是 /chat/completions，没有 /v1，返回 404。

Base URL 里不要出现 /responses、/chat/completions、/messages。这些路径客户端会自己加：

错误写法	正确写法
`https://hrouter.net/v1/chat/completions`	`https://hrouter.net/v1`
`https://hrouter.net/v1/responses`	`https://hrouter.net/v1`
`https://hrouter.net/v1/messages`	`https://hrouter.net`

https://hrouter.net/home、/keys、/docs 都是网页，不是 API。API 只有上面两种根地址。

工具	Base URL
Claude Code、Anthropic SDK	`https://hrouter.net`
Gemini CLI	`https://hrouter.net`
Codex、OpenAI SDK、Cherry Studio（OpenAI 类型）	`https://hrouter.net/v1`
Grok Build	`https://hrouter.net/v1`

用 curl 直接验证地址：

curl -i https://hrouter.net/v1/models \
  -H "Authorization: Bearer $HROUTER_API_KEY"

返回 200 就说明 OpenAI 系的地址是通的；再按上表检查你的工具里填的值是不是一致。