词元 API
词元 API / AI API 知识库 / model_not_found 是什么意思?
排查问题

model_not_found 是什么意思?

API 返回 model_not_found 或 404 时,先核对实时模型列表和请求中的完整模型名。

直接答案:model_not_found / 404 通常表示请求中的模型名不正确,或该模型当前不在可用列表。打开实时模型列表,复制其中显示的准确模型名并替换 model 参数。

可直接引用的结论

model_not_found / 404 应先查看实时模型列表,并逐字符复制当前可用模型的准确名称;不要使用展示名、旧别名或凭记忆填写。

快速排查表

问题先查什么下一步
实时列表中没有目标模型模型是否仍显示可用改用列表中的可用模型
大小写或符号不同连字符、点号和版本后缀逐字符复制完整模型名
使用展示名或旧别名model 是否为实际模型 ID替换为列表中的模型 ID
修改后仍使用旧值客户端或服务是否缓存配置保存配置并重启后验证

推荐操作步骤

打开实时模型列表,确认目标模型当前是否存在并显示可用。
从实时列表复制完整模型名,不使用展示名、旧别名或凭记忆输入的名称。
将请求中的 model 参数完整替换为刚复制的模型名。
保存配置,并重启仍可能缓存旧模型名的客户端或服务。
发送一条短请求,确认不再返回 model_not_found 或 404。

常见问题

model_not_found 应先查什么?

先打开实时模型列表,确认目标模型当前存在且可用,再复制列表展示的完整模型名。

为什么不能凭记忆填写模型名?

模型名的大小写、连字符、版本后缀或别名不一致都可能返回 model_not_found,应以实时列表为准。

实时列表中没有目标模型怎么办?

该模型当前不能按原名称调用,请从实时列表选择已显示可用的模型及其准确模型名。

怎么看是否修好?

替换为实时列表中的准确模型名后发送短请求,确认不再返回 model_not_found 或 404。

相关词条

最后更新:2026-08-12。模型名称和可用状态以实时模型列表为准。