# 模型 ID

> BigModel.io 的模型 ID 写法、如何列出 API Key 可调用的模型、OpenRouter 风格名称如何解析，以及未知模型会返回什么错误。

网页版: https://bigmodel.io/zh-cn/docs/model-ids · 更新于 2026-10-18

每个请求的 `model` 字段都是一个模型 ID，例如 `glm-5.3`。模型 ID 是小写的厂商名称，保留其中的点号。

| 系列 | 示例 ID |
|---|---|
| GLM（智谱） | `glm-5.3`、`glm-5.3-flash` |
| Kimi（月之暗面） | `kimi-k3` |
| DeepSeek | `deepseek-v4-pro`、`deepseek-v4-flash` |
| MiniMax | `minimax-m3` |

以上仅为示例。最新列表和价格见[模型目录](https://bigmodel.io/zh-cn/models)。请从模型页面复制 ID，不要手敲。

## 用 ID，不要用页面地址

模型页面的 URL 便于阅读，但不是模型 ID。`glm-5.3` 的页面是 `/models/glm-5-3`，点号变成了短横线。请求时始终使用页面上显示的 ID，保留点号并使用小写（`deepseek-v4-pro`，而不是 `DeepSeek-V4-Pro`）。

## Key 的分组决定可调用的模型

每个 API Key 都属于一个分组，分组决定 Key 能用哪些模型。目录里的模型不一定对每个分组都可用。列出你的 Key 可调用的模型：

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

```python [Python]
import os
from openai import OpenAI

client = OpenAI(base_url="https://bigmodel.io/v1", api_key=os.environ["BIGMODEL_API_KEY"])
for model in client.models.list():
    print(model.id)
```

```js [Node.js]
import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://bigmodel.io/v1", apiKey: process.env.BIGMODEL_API_KEY });
for await (const model of client.models.list()) console.log(model.id);
```

响应格式为 `{"object": "list", "data": [...]}`，每项都有 `id`。加上 `?configured_only=true` 只列出分组中已配置的模型。部分仅 Chat Completions 分组即使提供模型也会返回空列表，此时请使用目录中的 ID，并发一个请求测试。

`GET /v1/models` 需要余额大于 0，余额为 0 时返回 403 `INSUFFICIENT_BALANCE`。

## OpenRouter 风格名称

你也可以发送 OpenRouter 的 ID，例如 `z-ai/glm-5.3` 或 `deepseek/deepseek-v4-pro:nitro`。如果分组不提供这个完整名称，网关会尝试去掉路由后缀和 `provider/` 前缀。`:free` 永远不会被去掉。完整规则见 [OpenRouter 兼容](https://bigmodel.io/zh-cn/docs/openrouter-compat)。

不含 `/` 或 `:` 的普通 ID 不会被改写。

## 用量中的模型名

请始终发送目录中的 ID。[用量](https://bigmodel.io/usage)页面可能同时显示供应商对该模型的命名。

## 未知模型返回什么

文本模型没有「模型不存在」的 404。ID 拼错或分组不提供该模型时，返回：

```json
{"error":{"type":"api_error","message":"No available accounts: no available accounts supporting model: glm-5.3x"}}
```

HTTP 状态码为 503。请先检查 ID，ID 错误时重试没有用。如果 ID 正确且在你的 Key 的模型列表中，请查看[状态页](https://bigmodel.io/zh-cn/status)并稍后重试。

## 验证配置

运行 cURL 列表命令，从输出中挑一个 ID 发送一次请求。在[用量](https://bigmodel.io/usage)页面，这条请求会显示该模型。

## 常见问题排查

**503 `api_error`「No available accounts: no available accounts supporting model: X」。** ID 拼写错误（检查点号、大小写和短横线），或 Key 的分组不提供该模型。从模型页面复制 ID，或在提供该模型的分组中创建 Key。

**`/v1/models` 返回 403 `INSUFFICIENT_BALANCE`。** 模型列表需要余额大于 0，请在[充值](https://bigmodel.io/purchase)页面充值。

**`/v1/models` 的 `data` 为空数组。** 部分仅 Chat Completions 分组不发布模型列表。使用目录中的 ID 并发请求测试。

**工具提示模型无法识别。** Claude Code 等工具有自己的模型列表，请求仍然可能正常工作，见对应工具的指南，例如 [Claude Code](https://bigmodel.io/zh-cn/docs/claude-code)。

**`:free` 模型调用失败。** `:free` 是 ID 的一部分，永远不会被去掉。请使用目录中显示的完整 ID。

## 相关文档

- [OpenRouter 兼容](https://bigmodel.io/zh-cn/docs/openrouter-compat)：`provider/model` 名称与备选模型列表。
- [Models API 参考](https://bigmodel.io/zh-cn/docs/api-models)。
- [模型目录](https://bigmodel.io/zh-cn/models)与[价格](https://bigmodel.io/zh-cn/pricing)。