API model not found 怎么解决？
快速回答
model not found 的意思通常不是程序坏了，而是当前 API 地址找不到你填写的模型。先从服务商模型列表复制准确模型名，再确认 Base URL 对应的是同一个服务商和接口版本，最后检查 Key 是否有该模型权限。
常见原因
| 原因 | 典型表现 | 处理方式 |
|---|---|---|
| 模型名写错 | 名称少字符、大小写或别名不一致 | 从模型列表直接复制 |
| Base URL 填错 | 能连接但返回的模型集合不对 | 核对域名和 /v1 路径 |
| Key 没有模型权限 | 同一模型别人能用，当前 Key 不能用 | 查看套餐、分组或白名单权限 |
| 服务商未提供该模型 | 工具默认模型在当前平台不存在 | 换成该平台明确支持的模型 |
| 接口格式不匹配 | 工具与服务商兼容范围不同 | 核对请求格式和兼容说明 |
排查步骤
- 打开当前 API 服务商的模型列表，不要凭记忆手输模型名。
- 复制一个明确可用的模型名，替换到工具或代码配置中。
- 检查 API Key、Base URL 和模型名是否来自同一服务商账号。
- 确认 Base URL 是 API 入口，而不是官网、管理后台或另一个产品的地址。
- 用短请求测试；若模型列表接口可用，也可先读取列表确认该名称是否返回。
- 若仍失败，检查账号是否被分配到正确分组，或咨询服务商当前 Key 能访问的模型范围。
和其他错误怎么区分
401
401 是认证失败，重点检查 API Key 和环境变量，参考 Claude Code 401 错误怎么解决？。
403
403 常表示已有身份但没有访问权限，例如模型未授权或策略限制。
429
429 表示额度、频率、并发或上游拥堵，而不是模型名不存在，参考 GPT API 429 错误怎么解决？。
总结
处理 model not found 的顺序很简单：先复制服务商实际提供的模型名，再确认 Base URL 与 Key 属于同一服务，再看权限。不要在没有依据的情况下连续尝试不同模型名。