模型 ID

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

以上仅为示例。最新列表和价格见模型目录。请从模型页面复制 ID，不要手敲。

#用 ID，不要用页面地址

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

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

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

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

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)

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 兼容。

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

#用量中的模型名

请始终发送目录中的 ID。用量页面可能同时显示供应商对该模型的命名。

#未知模型返回什么

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

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

HTTP 状态码为 503。请先检查 ID，ID 错误时重试没有用。如果 ID 正确且在你的 Key 的模型列表中，请查看状态页并稍后重试。

#验证配置

运行 cURL 列表命令，从输出中挑一个 ID 发送一次请求。在用量页面，这条请求会显示该模型。

#常见问题排查

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

/v1/models 返回 403 INSUFFICIENT_BALANCE。 模型列表需要余额大于 0，请在充值页面充值。

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

工具提示模型无法识别。 Claude Code 等工具有自己的模型列表，请求仍然可能正常工作，见对应工具的指南，例如 Claude Code。

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

#相关文档

• OpenRouter 兼容：provider/model 名称与备选模型列表。
• Models API 参考。
• 模型目录与价格。