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 配置错误,还是上游模型已经调整。