GPT 显示 model not found 时，先确认报错来自 ChatGPT 网页，还是自定义 API。API 的模型名、权限、请求路径或服务端路由都可能导致模型不可用；/v1/v1 则提示路径被重复拼接。不要仅凭这句话判断必须充值，也不要连续重试同一个失败请求。
先区分 ChatGPT 与 API 场景
| 使用场景 | 先做什么 | 不要混用的处理方法 |
|---|---|---|
| ChatGPT 官方网页或客户端 | 核对账号与当前可选模型，尝试新对话，并检查官方服务状态；持续失败时联系官方支持 | 不需要填写 AIFast Link Base URL，也不能用第三方 API 充值修复官方网页 |
| 第三方聊天工具 | 确认实际服务商、客户端版本、自定义模型字段与最终请求地址 | 工具显示的模型名称不一定是实际发送的模型 ID |
| 自己的代码或 API 客户端 | 保存状态码与脱敏错误响应，再核对模型 ID、Key 权限、端点和分组 | 不要把任何 404 都当成余额不足或模型下架 |
ChatGPT 网页显示 model not found，先做哪一步？
如果错误出现在 ChatGPT 官方网页或客户端，先记录当前账号、所选模型和发生时间，再用当前可选模型新建对话作对照。只在旧对话出现和所有新对话都失败，是两种不同的现象；这项对照不能单独证明模型下架或账号权限变化。持续失败时将脱敏信息提交官方支持，不要套用下方 Link API 命令。
第三方客户端报错，先确认请求发给了谁
检查客户端实际请求的域名和模型字段，而不只看界面上的“GPT”名称。官方账号登录、第三方 API Key 和不同服务商的 Key 不可互换；只向你选择的服务商发送它签发的密钥。路径正确但同一个 Key 仍失败时，再按下面的响应类型排查权限与路由。
本文后续步骤针对 AIFast Link API 接入。文档核对日期为 2026-10-26，不代表已对所有模型进行付费调用测试，也不是当前服务故障公告。
Link 模型未找到：先看协议，再看分组
模型广场展示的是目录，不是任意 Key 的授权清单。先用 Link Key 请求 /v1/models，核对精确 ID 与令牌分组；月卡适用分组与模型可见范围也要一起确认。
gpt-image-2 属于图像生成用途，不应因为它出现在 GPT 列表就直接填入 Codex 的聊天模型字段。OpenAI SDK 的基础路径用 /v1，而 Claude Code 的基础地址不用手动追加 /v1；最终请求不能出现 /v1/v1。
快速结论
在同一域名使用同一个 Key 查询 /v1/models，原样复制 id，再检查客户端最终发送的 URL。列表没有目标模型时，核对权限、分组与开放状态；有模型也不保证所有协议都支持。HTML 错误页提示请求可能落到了前端、代理或防护页面，不能仅凭它判断模型是否存在。
| 实际响应 | 优先检查 | 下一步 |
|---|---|---|
| 404 JSON，包含 model_not_found | 精确模型 ID、当前 Key 权限、所选端点 | 同 Key 查询模型目录；配置无误时交给服务商核查路由 |
| 404 或 200，但响应为 HTML | Host、完整路径、代理与防护页面 | 检查 Content-Type；不要按 JSON 模型响应解析 |
| 401 或 403 | 认证头、Key 有效性与资源权限 | 先解决认证或权限，不盲目替换模型 |
| 429 | 错误正文中的额度或速率限制说明 | 按具体原因处理，不把所有 429 都解释成余额不足 |
| 5xx、超时或连接失败 | 服务状态、网络与上游可用性 | 使用有上限的退避重试；持续失败保留请求 ID |
不同兼容服务的错误码可能不同，应结合状态码、Content-Type 与错误正文判断，不只匹配一句报错文字。
开始前检查
记录客户端实际发送的完整 URL 和模型字段。不要只看设置页面里填写了什么，因为客户端可能会自动追加路径或替换模型别名。
不确定地址会如何拼接时，可以先用 Base URL 在线检查器生成建议值和最终请求路径。该工具只在浏览器分析 URL 字符串，不会请求目标接口，也不需要 API Key。
可复现的路径检查：为什么出现 /v1/v1？
下面是本地工具的路径复现，不是客户故障记录，也没有发送付费模型请求。输入、预期结果和核验边界都可以在浏览器重复检查。
- 在地址检查器输入
https://www.aifast.link/v1，不勾选客户端自动添加/v1。建议 Base URL 应保留该地址，Chat 请求路径应为https://www.aifast.link/v1/chat/completions。 - 只有确认客户端会自动添加
/v1时才勾选该项。建议填入根地址https://www.aifast.link，最终 Chat 路径仍应只有一个/v1。 - 对照客户端实际日志；如果它仍发往
/v1/v1/chat/completions，应修正客户端的拼接配置。工具不会替客户端改设置，也不能验证模型权限或上游可用性。
路径修正只排除一种配置问题。仍收到 model_not_found 时，继续用同一个 Key 核对精确模型 ID 和端点；不要把路径检查通过当成模型调用成功。
配置步骤
获取真实模型 ID
curl --connect-timeout 10 --max-time 30 --include https://www.aifast.link/v1/models \
-H "Authorization: Bearer ${AIFAST_API_KEY:?Set AIFAST_API_KEY locally before running}"从返回结果复制 id 字段。以下内容通常不能直接当模型 ID：
- 网页卡片标题。
- 中文模型名称。
- 厂商名称。
- “最新”“旗舰”“高速”等营销标签。
模型列表很长时，可用 Link 独立仓库的离线检查器精确比对 data[].id。先把不含响应头和密钥的 JSON 保存在仓库外；检查器不联网、不读取环境变量。退出码 0 表示快照包含 ID，2 表示缺失，1 表示输入无效；不能把快照命中当成调用成功。Gemini 示例也可用于理解大小写与协议差异。
检查最终 URL
正确的 Chat Completions 请求通常类似：
https://www.aifast.link/v1/chat/completions错误示例：
https://www.aifast.link/v1/v1/chat/completions
https://www.aifast.link/chat/completions
https://www.aifast.link/v1/models/chat/completions如果客户端自动追加 /v1，Base URL 就填写根域名；如果客户端要求完整兼容地址，则保留 /v1。
接口与客户端边界
模型列表里有，但调用仍然不存在
模型可能只支持特定接口或当前账号权限不同。核对模型是否支持 Chat Completions、Responses、图像或视频任务，不要用文本接口调用非文本模型。
404 返回的是网页 HTML
说明请求可能落到了前端站点，而不是 API 路由。检查 Host、路径和反向代理，不要把 HTML 错误页当作模型返回。
工具自动把模型名改掉
部分客户端只允许内置模型或会把显示名称映射到固定 ID。查看请求日志确认最终发送值；必要时使用客户端提供的自定义模型功能。
下一步
提交脱敏诊断信息
先核实请求域名属于你选择的服务商，Key 只放在本地环境变量中。向客服提交下面的信息前，删除 Authorization、Cookie、完整 Key、用户输入以及 URL 查询参数中的敏感内容；不要直接公开完整调试日志。
Client and version:
Time and timezone:
Request method and URL (redacted):
Model ID and endpoint:
HTTP status and Content-Type:
Error code and message (redacted):
Request ID (if provided):
Same model visible with the same key: yes / no修正模型名和地址后，用非流式短请求验证。短请求成功后，再恢复工具调用、长上下文和流式输出。
如果仍然返回 401、429 或 5xx，继续查看 API 错误排查；如果地址已经正确但需要验证真实模型和协议，可运行免费模型检测。
使用 Cursor2API 等社区协议转换项目时，模型目录还可能随上游入口变化。请结合 Cursor2API 风险检查与迁移指南判断是模型 ID 配置错误，还是上游模型已经调整。