AI API 404 怎么解决?Base URL、重复 /v1 与接口支持检查
AI API 返回 404,先查看最终请求路径。OuraiC 的 OpenAI 兼容基址是 https://ouraic.cn/v1,但 SDK 基址、直接 HTTP 路径和不同工具地址不能混用。

图:按本文操作要点制作的说明图,不是后台或调用成功截图。
常见路径问题
| 实际路径 | 可能原因 |
|---|---|
/v1/v1/chat/completions |
客户端又加一次版本前缀 |
/chat/completions/chat/completions |
完整路径当作 SDK 基址 |
| 网站页面路径 | 请求落到前端路由 |
| 不受支持的接口路径 | 当前分组或服务没有对应功能 |
去掉 Key 等敏感信息后记录 URL,检查是否多余空格或全角字符。
SDK 与 curl 的区别
SDK 配置基址,随后按方法追加路径;curl 直接请求需要完整 URL。比如普通聊天完整地址包含 /v1/chat/completions。
不要在 SDK 的 base_url 中写完整聊天路径,再调用聊天方法。
Responses 与 Messages
Codex、Claude Code 和普通聊天可能使用不同协议。聊天接口成功,不代表 Responses 或 Anthropic 相关路径都支持。本站文档的工具专项地址应分别核对。
当前分组不明确时,先确认支持,再改配置,不把所有 404 都当成少写了 /v1。
200 但返回 HTML
有些站点会把未知路径回退到首页。这时 HTTP 200 也可能返回网页,客户端随后 JSON 解析失败。检查 Content-Type 与响应正文开头,判断是否为 HTML。
网页能打开不证明 API 正常;在浏览器输入模型接口又通常不是带认证的 POST,所以也不能作为唯一判断。
修正后验证
用最小短请求核对状态与响应,再看本站日志。若变成 401,继续查认证;若模型或渠道错误,继续查权限和分组。
使用本地路由时,同时查本地 URL 和路由器上游路径。路由模式变化后,旧进程可能仍使用原配置。
需要提供什么
请求方法、路径、状态、脱敏响应和工具版本足以开始排查。不要公开完整认证头。
相关基础见 Base URL 教程,Codex 专项见 Codex 地址。