错误排查

API model not found 怎么解决:模型 ID、/v1/v1 与 404 排查

解决大模型 API 的 model not found、404 和 /v1/v1:从 /v1/models 复制真实模型 ID,检查账号权限、接口类型以及客户端最终请求地址。

更新于 2026-07-21已核对 2026-07-21预计阅读 6 分钟适用于 OpenAI Compatible API
配置字段已按公开文档核对;模型、价格和可用能力会变化,请以控制台与接口实时返回为准。
所属专题:OpenAI Compatible API 接入与排错中心

model not found/v1/v1 都属于配置型错误。反复充值、重建 Key 或提高重试次数通常没有用,应该先核对模型 ID 和最终请求地址。

快速结论

先调用 /v1/models 并原样复制返回的 id,再查看客户端日志中的完整 URL。列表中没有模型通常是账号权限或开放状态问题;出现 /v1/v1 是客户端与配置重复追加版本路径;返回 HTML 404 则说明请求没有进入 API 路由。

开始前检查

记录客户端实际发送的完整 URL 和模型字段。不要只看设置页面里填写了什么,因为客户端可能会自动追加路径或替换模型别名。

不确定地址会如何拼接时,可以先用 Base URL 在线检查器生成建议值和最终请求路径。该工具只在浏览器分析 URL 字符串,不会请求目标接口,也不需要 API Key。

配置步骤

获取真实模型 ID

curl https://www.aifast.hk/v1/models \
  -H "Authorization: Bearer $AIFAST_API_KEY"

从返回结果复制 id 字段。以下内容通常不能直接当模型 ID:

  • 网页卡片标题。
  • 中文模型名称。
  • 厂商名称。
  • “最新”“旗舰”“高速”等营销标签。

检查最终 URL

正确的 Chat Completions 请求通常类似:

https://www.aifast.hk/v1/chat/completions

错误示例:

https://www.aifast.hk/v1/v1/chat/completions
https://www.aifast.hk/chat/completions
https://www.aifast.hk/v1/models/chat/completions

如果客户端自动追加 /v1,Base URL 就填写根域名;如果客户端要求完整兼容地址,则保留 /v1

常见问题

模型列表里有,但调用仍然不存在

模型可能只支持特定接口或当前账号权限不同。核对模型是否支持 Chat Completions、Responses、图像或视频任务,不要用文本接口调用非文本模型。

404 返回的是网页 HTML

说明请求可能落到了前端站点,而不是 API 路由。检查 Host、路径和反向代理,不要把 HTML 错误页当作模型返回。

工具自动把模型名改掉

部分客户端只允许内置模型或会把显示名称映射到固定 ID。查看请求日志确认最终发送值;必要时使用客户端提供的自定义模型功能。

下一步

修正模型名和地址后,用非流式短请求验证。短请求成功后,再恢复工具调用、长上下文和流式输出。

如果仍然返回 401、429 或 5xx,继续查看 API 错误排查;如果地址已经正确但需要验证真实模型和协议,可运行免费模型检测

使用 Cursor2API 等社区协议转换项目时,模型目录还可能随上游入口变化。请结合 Cursor2API 风险检查与迁移指南判断是模型 ID 配置错误,还是上游模型已经调整。

已核对来源

参考与核对来源

下一步

先检测当前接口,再决定修复、迁移或创建测试 Key

用临时限额 Key 检查模型声明、Token、SSE 和工具调用;需要新接口时再核对模型与价格。

模型质量检测查看模型与价格注册使用