遇到 model not found 或 /v1/v1，先核对模型 ID 和最终请求地址，再检查权限、目录与上游状态变化。反复充值、重建 Key 或提高重试次数通常不能定位原因。
快速结论
先看客户端实际发送的 URL、HTTP 状态和错误正文，再用同一 Key 查询 /v1/models 并复制完整 id。出现 /v1/v1 应先修路径；JSON 中的 model not found 应检查模型 ID、接口和权限；HTML 404 可能来自前端回退、代理或错误页，不能只凭 404 就认定模型下架。
model not found 解决方法：按响应分流
| 看到的结果 | 下一步 | 不能据此认定 |
|---|---|---|
| JSON 提示 model not found 或 model_not_found | 用同一 Key 核对模型 ID、令牌权限和目标接口 | 平台所有模型不可用 |
| HTML 404 或网页内容 | 核对实际主机、路径、Content-Type 和代理错误页 | 请求已到模型上游 |
| 最终路径有 /v1/v1 | 去掉客户端与配置重复追加的版本路径 | API Key 一定错误 |
| /v1/models 返回 401 | 先处理认证，再排查模型 | 模型已经下架 |
| 模型列表没有目标 ID | 核对账号可见范围与模型目录是否完整 | 所有账号都无法使用该模型 |
| 模型列表有目标 ID，但生成失败 | 检查实际发送的 ID、接口类型和错误正文 | 列表成功就等于生成可用 |
404 的标准语义也允许服务不公开资源是否存在。结合响应正文和权限核验，而不是用一次状态码推断平台能力。
开始前检查
记录客户端实际发送的完整 URL 和模型字段。不要只看设置页面里填写了什么，因为客户端可能会自动追加路径或替换模型别名。
不确定地址会如何拼接时，可以先用 Base URL 在线检查器生成建议值和最终请求路径。该工具只在浏览器分析 URL 字符串，不会请求目标接口，也不需要 API Key。
配置步骤
获取真实模型 ID
if [ -n "$AIFAST_API_KEY" ]; then
curl --connect-timeout 10 --max-time 30 -sS -i \
https://www.aifast.hk/v1/models \
-H "Authorization: Bearer $AIFAST_API_KEY"
else
printf '%s\n' 'AIFAST_API_KEY is not set'
fi只使用 HK 平台创建的 Key，并从 JSON 返回结果复制完整 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、图像和视频接口都可用；保留同一个 Key、同一个模型 ID，按平台说明只改变接口这一项做短请求对照。生成请求可能产生费用。
404 返回的是网页 HTML
可能落到了前端站点或代理错误页。检查 Host、路径、Content-Type 和请求 ID，不要把 HTML 错误页当作模型返回。
提交工单时提供什么
提供发生时间与时区、客户端版本、脱敏后的完整路径、接口类型、实际发送的模型 ID、HTTP 状态、错误正文和请求 ID。不要提供完整 API Key、Cookie、认证头或生产提示词。没有付费请求和服务端日志时，只能确认配置检查范围，不能宣称某个模型已恢复。
工具自动把模型名改掉
部分客户端只允许内置模型或会把显示名称映射到固定 ID。查看请求日志确认最终发送值；必要时使用客户端提供的自定义模型功能。
下一步
修正模型名和地址后，用非流式短请求验证。短请求成功后，再恢复工具调用、长上下文和流式输出。
如果仍然返回 401、429 或 5xx，继续查看 API 错误排查；地址正确后，可运行模型质量检测检查协议与响应字段。检测结果不能单独证明底层模型身份，实际 API 调用可能产生费用。
使用 Cursor2API 等社区协议转换项目时，模型目录还可能随上游入口变化。请结合 Cursor2API 风险检查与迁移指南判断是模型 ID 配置错误，还是上游模型已经调整。