# 解决 404 model_not_found 和 model_retired

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

网页版: https://bigmodel.io/zh-cn/docs/error-model-not-found · 更新于 2026-10-27

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. 从[模型目录](https://bigmodel.io/zh-cn/models)复制 ID，或者列出你的 Key 能调用的模型：

```bash
curl https://bigmodel.io/v1/models -H "Authorization: Bearer $BIGMODEL_API_KEY"
```

2. 注意点和短横线：`glm-5.3`、`deepseek-v4-pro`、`kimi-k3`。模型 ID 不区分大小写，`z-ai/glm-5.3` 这类带厂商前缀的 ID 也能用。
3. 遇到 `model_retired`，换成报错里给出的模型。
4. 在 Claude Code 里，把 `ANTHROPIC_MODEL` 和三个 `ANTHROPIC_DEFAULT_*_MODEL` 都设为支持 `/v1/messages` 的模型。见 [Claude Code](https://bigmodel.io/zh-cn/docs/claude-code)。

## 常见问题排查

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

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

## 相关文档

- [模型 ID](https://bigmodel.io/zh-cn/docs/model-ids)
- [列出模型](https://bigmodel.io/zh-cn/docs/api-models)
- [错误码与响应](https://bigmodel.io/zh-cn/docs/errors)