解决 404 model_not_found 和 model_retired

BigModel.io 返回 404 model_not_found 或 model_retired 的原因，如何获取准确的模型 ID，以及如何避免 Claude Code 请求 claude-* 模型。

本页目录
  1. 这是什么意思
  2. 怎么解决
  3. 常见问题排查
  4. 相关文档

Key 没问题，但请求里的模型 ID 和你能调用的模型对不上：

json
{ "code": "model_not_found", "message": "The model `glm-5.4` does not exist or is not available.", "error": { "message": "The model `glm-5.4` does not exist or is not available.", "type": "invalid_request_error", "code": "model_not_found" } }

#这是什么意思

  • model_not_found：ID 拼错了，或者模型不在目录中。按量付费的 Key 能调用目录里的所有模型；套餐 Key 只能调用文本模型。
  • model_retired：模型已下架。报错会给出替代模型：“The model X has been retired. Use Y instead.”
  • /v1/messages 上出现 claude-* 模型：有模型槽位没设，Claude Code 请求了它默认的 Claude 模型。报错原文是：“The model claude-… is not available on BigModel.io. In Claude Code, set ANTHROPIC_MODEL and ANTHROPIC_DEFAULT_HAIKU_MODEL (and the Sonnet/Opus defaults) to a supported model: …”

#怎么解决

  1. 从模型目录复制 ID，或者列出你的 Key 能调用的模型：
bash
curl https://bigmodel.io/v1/models -H "Authorization: Bearer $BIGMODEL_API_KEY"
  1. 注意点和短横线：glm-5.3、deepseek-v4-pro、kimi-k3。模型 ID 不区分大小写，z-ai/glm-5.3 这类带厂商前缀的 ID 也能用。
  2. 遇到 model_retired，换成报错里给出的模型。
  3. 在 Claude Code 里，把 ANTHROPIC_MODEL 和三个 ANTHROPIC_DEFAULT_*_MODEL 都设为支持 /v1/messages 的模型。见 Claude Code。

#常见问题排查

curl 能用，工具里不行。 工具可能给模型名加了前缀或改了大小写。查看工具的请求日志，或者手动输入 ID，不要从预设列表里选。

图片或视频模型返回 400 model_endpoint_mismatch。 模型存在，但属于另一个接口。按报错里给出的接口调用，例如 /v1/videos。

#相关文档

更新于 · 以 Markdown 查看