UNKNOWN_MODEL 错误
修复 UNKNOWN_MODEL：核对准确 Model ID、模型服务商 Base URL 和模型列表，再选择或添加真实存在的模型。
本页内容
核对错误信息
在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。
UNKNOWN_MODELunknown modelDSH UNKNOWN_MODEL搜索或求助时尽量复制完整报错，同时删除 API Key、私有仓库名、用户名和敏感路径。
处理要点
打开“设置 → 模型”，核对服务商 Base URL 和当前模型列表，再选择真实存在的准确 Model ID。不要直接照搬营销名称或旧截图。
错误含义
当前会话引用的 Model ID 并不存在于正在使用的模型服务商配置中。
常见原因
- Model ID 已改名、下线或输入错误。
- 默认模型仍指向已删除或已替换的模型服务商。
- 模型发现失败，所以自定义模型没有被添加。
- 旧会话仍保存着与当前默认值不同的模型。
对应文档与源码
DSH 相关链接固定到 0.1.5-rc.2 / c291e79；涉及系统和运行环境的说明见对应官方文档。
修复步骤
- 01
逐字核对 Model ID
把当前 Model ID 与服务商实际模型列表对比。大小写、标点和服务商前缀都可能影响匹配。
- 02
确认模型属于正确的服务商
打开“设置 → 模型”，确认该模型属于你已经配置 Base URL 和凭据的服务商。
- 03
刷新或手动添加模型
服务商支持 GET /models 时使用模型发现；不支持时，手动添加已经确认无误的 Model ID。
- 04
用新会话测试
选择修正后的模型。如果旧会话仍引用旧模型，直接新建会话。
检查结果
- 所选模型显示在正确的模型服务商下。
- 新会话发送简单任务后不再出现 UNKNOWN_MODEL。
不要做什么
- 不要根据营销名称猜 Model ID。
- 不要认为修改全局默认模型会自动改写旧会话。
常见问题速查
UNKNOWN_MODEL 怎么修？
打开“设置 → 模型”，核对服务商 Base URL 和当前模型列表，再选择真实存在的准确 Model ID。不要直接照搬营销名称或旧截图。
UNKNOWN_MODEL 是什么意思？
当前会话引用的 Model ID 并不存在于正在使用的模型服务商配置中。
怎么确认 UNKNOWN_MODEL 已经修好？
所选模型显示在正确的模型服务商下。 新会话发送简单任务后不再出现 UNKNOWN_MODEL。
来源与版本
本页于 2026-09-11 对照官方仓库核验。网站使用的已发布版本基线为 0.1.5-rc.1；源码核验快照为 0.1.5-rc.2（c291e79）。