排查 OpenAI 兼容接口 404
AI 总结
这篇教程建议,遇到 OpenAI 兼容接口返回 404 时,应先检查最终拼接出的请求地址,再考虑更换模型。文中展示了重复添加 /v1 如何导致请求失败,并提供终端与 curl 命令,帮助区分路由、模型 ID、HTML 错误页和配置加载问题。
深度见解
先核对完整请求路径,可以避免在真正的路由错误尚未解决时,只更换模型名并重复请求同一错误地址。
假设配置文件里写着 API_BASE_URL=https://api.vsoui.com/v1,业务代码里写着 ${API_BASE_URL}/v1/chat/completions。分开看,两行都挺眼熟。拼在一起,问题就出来了:
https://api.vsoui.com/v1/v1/chat/completions
如果网关没有这条路由,请求就可能收到 404。这时候换模型名,只会带着新模型再走一遍同样的错路。
先把最终地址打印出来
如果服务商文档给的接口前缀已经以 /v1 结尾,手写 Chat Completions 请求时,只需要再拼上 /chat/completions。下面这两行可以直接在终端里跑,不需要 Key: