Model ID 怎么找？模型名称、显示名与 API 权限区别
API 的 model 字段应填写服务接受的 Model ID。品牌、系列名和客户端显示名称，不一定就是请求参数。OuraiC 用户应从当前模型定价页面复制完整 ID，再核对令牌分组。
图：按本文操作要点制作的说明图，不是后台或调用成功截图。
三种名称
| 名称 | 含义 | 是否能直接请求 |
|---|---|---|
| 品牌或系列 | GPT、DeepSeek、Gemini | 通常范围过大 |
| 显示名称 | 客户端中自行起的名称 | 需查对应真实 ID |
| Model ID | 定价页完整字符串 | 还需具备权限 |
模型目录会更新。旧 ID 可能下线，新 ID 也可能只出现在特定分组。本文不把某个版本写成永久可用的推荐。
获取与验证
在本站定价页搜索目标系列，查看模型完整名称与可用分组。复制时保留大小写、连字符和后缀，再为对应分组创建令牌。
若分组支持 /v1/models，可查询模型列表。但公共目录不必然等于单把 Key 的权限，最终应通过一条短请求确认。
有模型为什么还会失败
模型可能属于另一分组，也可能被令牌模型白名单限制。先比较请求 ID 与目录中的字符串，再看错误是权限、渠道还是协议问题。
不要仅确认“名字包含 GPT”。同系列的不同版本可能需要不同协议或支持不同参数，尤其是用于编程 Agent 时。
客户端前缀与上游 ID
有些工具用 provider/model 表示本地供应商和模型；有些 SDK 直接填站点 ID。这是两层标识。工具侧需要前缀，不等于上游 API 也接受同一个前缀。
迁移配置时，应查看最终发送的 model。随意加 openai/，可能把正确 ID 变成站点不认识的字符串。
留下可复查的记录
记录工具版本、协议、Model ID、分组和测试时间，不记录完整 Key。更新模型时重新测试这些组合。
聊天成功后，还要测试业务需要的多轮、工具调用和流式。名字相似不代表能力相同。具体错误可阅读 model not found 排查。