接口地址少了 `/v1`，为什么会报错

接口地址少了/v1为什么会报错很多 AI 软件在配置供应商时都会让你填写一个Base URL。有时候文档、控制台、别人分享的地址看起来都差不多但实际能不能用关键往往差在最后的/v1。比如原来填的是https://api.example.com请求模型列表时报错FormatException: Unexpected character !doctype html加上/v1后变成https://api.example.com/v1问题就解决了。这个报错的核心意思是软件本来想拿到 JSON 数据但服务器返回了一个网页。正常模型接口应该返回类似{ data: [] }但实际返回的是!doctype html这说明请求没有打到真正的 API 接口而是打到了网页入口、控制台页面、404 页面或者某个网关错误页。/v1的作用就是告诉服务端我要访问的是第一版 API 接口不是普通网页。所以配置 OpenAI 兼容接口时优先检查三件事Base URL是否是 API 地址不是官网或控制台地址地址末尾是否需要/v1API Key 是否正确没有多复制空格可以记住一个简单判断看到!doctype html先查 URL。因为这类错误通常不是模型坏了也不是 Key 一定错了而是软件请求到了网页不是接口。大多数情况下把地址改成供应商文档里的 OpenAI-compatible API 地址并补上/v1就能解决。