404 不一定表示网站不存在。在 AI API 场景里，它通常代表两类问题：请求发到了错误路径，或者你填写的模型名称不存在。部分客户端还会把分组权限不足包装成 model_not_found，所以排查时要把地址、模型和 Key 放在一起看。
先分清是哪一种 404
查看错误正文中的关键词：
| 错误特征 | 更可能的原因 |
|---|---|
| 页面式 404、找不到路由 | API 地址拼错 |
model_not_found | 模型名称错误或不可用 |
not_found_error | Claude 路径或模型配置错误 |
| 客户端只显示“请求失败” | 需要查看客户端日志中的真实响应 |
不要只看客户端弹窗标题。找到原始状态码和错误正文，通常能少走很多弯路。
检查一：OpenAI 工具有没有带 /v1
OpenAI SDK、Codex 和多数桌面客户端的基础地址通常是：
https://zivv.pro/v1常见错误包括：
- 写成
https://zivv.pro，客户端没有自动补/v1 - 写成
https://zivv.pro/v1/chat/completions，客户端又重复拼接路径 - 多写一个斜杠或复制了不可见字符
基础地址只填到 /v1，具体接口由 SDK 或客户端补全。端点列表见 API 端点说明。
Claude Code 是例外：
export ANTHROPIC_BASE_URL=https://zivv.proClaude Code 的地址不要加 /v1。
检查二：模型名称是否准确
模型名称不是展示标题，大小写、连字符和版本号都可能影响结果。最稳妥的方式不是凭记忆输入，而是从 模型广场 或模型接口复制。
curl https://zivv.pro/v1/models \
-H "Authorization: Bearer sk-your-key"从返回的 id 字段复制目标模型。不要根据旧教程猜测新版本名称，因为模型会更新、迁移或停止提供。
检查三：Key 分组是否支持该模型
同一个平台可能有多个接入分组，分别适合 Claude Code、OpenAI 兼容调用或其他场景。模型出现在公开列表中，不代表每个 Key 都有相同权限。
检查创建 Key 时选择的分组，并确认：
- 分组支持目标模型
- Key 没有模型白名单限制
- Key 没有过期或禁用
- 当前模型不是仅供特定协议使用
如果一个 Key 能调用 GPT，却找不到 Claude，通常应先检查分组和协议，而不是重装客户端。
检查四：客户端有没有保留旧模型
模型名称调整后，客户端下拉列表可能仍保存旧值。处理方法：
- 刷新模型列表
- 删除旧的自定义模型
- 从模型广场复制新名称
- 重新选择服务商和模型
- 完全退出并重新打开客户端
Codex 和自动化脚本还要检查项目配置、用户配置和环境变量是否同时定义了模型。优先保留一个明确来源，避免互相覆盖。
用最小请求确认
地址和模型都确认后，发送一个最小请求。先不要带长 Prompt、工具调用或图片：
curl https://zivv.pro/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"your-model-id","messages":[{"role":"user","content":"Reply OK"}]}'最小请求成功，说明平台、Key、地址和模型都正常，剩下的问题在原客户端配置或请求内容。
404 排查清单
- OpenAI 工具使用
https://zivv.pro/v1 - Claude Code 使用
https://zivv.pro - 模型名称从当前列表复制
- Key 分组允许目标模型
- 清理客户端缓存的旧模型
- 用最小 curl 请求复现
完整的 Codex 配置可以看 Codex 接入指南，错误字段含义见 错误码说明。如果你刚开始使用 API，建议先完成 新手接入指南 的四项检查。