为什么你只改了 base_url，LLM API 还是报 404？

Mon, 15 Jun 2026 17:00:00 +0800

你在 Go 项目里接一个新的模型供应商。

文档写着“OpenAI compatible”。你心里一松：那不就是改三个值吗？

1
2
3


BaseURL: "https://api.xxx.com/v1/chat/completions"
APIKey: "sk-..."
Model: "xxx-model"

结果一跑，404。

你把 key 换了，把 model 换了，把代理关了，把日志打开，最后才发现真正发出去的 URL 长这样：

1

https://api.xxx.com/v1/chat/completions/chat/completions

SDK 已经会在 base URL 后面拼 /chat/completions，你又把 endpoint path 塞进了 base URL。

这类问题看起来很低级。

但它背后有一个更容易被忽略的误判：很多人把“平台入口”和“协议动作”混成了一个东西。

base URL 只是告诉客户端：请求要发到哪台服务、哪个 API 根路径。

真正决定请求体怎么写、响应体怎么读、流式事件怎么解析的，是后面的 endpoint path。

/v1/chat/completions、/v1/messages、/v1/responses 不是三个 URL 后缀。

它们是三套协议契约。

404 只是第一层症状

很多 LLM API 的接入问题，第一眼都像配置问题。

404，像是 URL 配错。

400，像是参数传错。

流式读不到数据，像是网络断了。

响应字段找不到，像是 SDK 版本不对。

这些判断不一定错，但经常只停在表层。

你真正要问的是：我现在调用的到底是哪一种协议？

同样叫“发一段 prompt，让模型回一句话”，落到 API 上，至少有三种常见形态。