model not found 怎么解决？模型 ID、分组和客户端前缀排查

API 提示 model not found 或模型不存在，可能是名称错误，也可能是当前 Key 没有权限。OuraiC 用户先比较请求的完整 ID 与当前目录，再核对令牌分组，不能只看品牌名相似。

图：按本文操作要点制作的说明图，不是后台或调用成功截图。

检查完整字符串

保留大小写、连字符、版本和后缀。中文显示名通常不等于 API ID。不要使用别家服务教程里的旧模型名称，或根据新闻自行拼接新 ID。

模型更新后，旧 ID 可能不再提供。查当前目录，不能把历史成功当作永久支持。

查真实权限

公共定价页展示站点目录，你的 Key 只拥有相应分组和限制下的权限。检查令牌分组、模型白名单、状态和额度。

同一模型出现在多个分组时，先确认你的 Key 对应哪一个。不要因为公共页面有该 ID 就立即认定服务故障。

客户端前缀问题

工具可能用 provider/model 表示本地来源，但上游接受的是另一字符串。检查最终 model 字段，区分供应商标识、显示名和真实 ID。

不要给所有请求统一加 openai/。某些路由工具需要前缀，普通 SDK 未必需要。

测试方法

用已确认权限的模型发送最小短文本，去掉非必要参数。如果这个基线成功，再测试原目标。仅换成其他模型成功，说明新组合可用，不证明原模型一定下线。

若列表接口可用，可查询当前 Key 返回范围；列表也不是完整工具兼容证明，实际请求仍需要验证。

协议与渠道

同名模型在 Chat、Responses 或 Messages 下不一定都支持。模型错误正文可能来自路由映射，检查目标协议和上游实际 ID。

如果名称和权限已正确，但提示无渠道，转查上游状态，不继续改拼写。

更新配置

修正后同步修改默认、备用与辅助模型，避免主模型成功、回退时再失败。发短请求并看日志，再进行真实小任务。

保留模型、分组、协议和测试时间。具体名称基础见 Model ID 教程。