列出模型

BigModel.io 的 GET /v1/models 接口：列出 API Key 所在分组提供的模型 ID，兼容 OpenAI 和 Anthropic 客户端；需要余额大于 0 或有生效中的套餐。

GEThttps://bigmodel.io/v1/models
本页目录
  1. 请求
  2. 认证
  3. 查询参数
  4. 响应
  5. 响应字段
  6. 示例
  7. 说明
  8. 相关文档

列出 Key 所在分组提供的模型，供工具填充模型选择列表。结果取决于 Key 的分组，而不是账户。和 GET /v1/usage 不同，这个接口会做计费检查：余额为 0 且没有生效中的套餐时返回 403 INSUFFICIENT_BALANCE。

#请求

http
GET https://bigmodel.io/v1/models

#认证

请求头 值
Authorization Bearer $BIGMODEL_API_KEY
x-api-key $BIGMODEL_API_KEY

任选其一。

#查询参数

名称 类型 必填 说明
configured_only boolean 分组未配置模型时返回空列表，而不是内置默认列表。

#响应

状态码 含义
200 模型列表。
400 api_key_in_query_deprecated（Key 放在了查询参数里），或 invalid_request_error：请求体为空或不是合法 JSON、缺少 model、stream 不是布尔值等。
401 API_KEY_REQUIRED、INVALID_API_KEY、API_KEY_DISABLED、USER_NOT_FOUND、USER_INACTIVE。
403 INSUFFICIENT_BALANCE、API_KEY_EXPIRED、ACCESS_DENIED（IP 规则）、SUBSCRIPTION_NOT_FOUND、SUBSCRIPTION_INVALID，或 permission_error（Key 未分配分组、分组不允许该接口）。
429 API_KEY_QUOTA_EXHAUSTED、USAGE_LIMIT_EXCEEDED（套餐额度），或 rate_limit_exceeded / rate_limit_error（Key 的 5 小时/1 天/7 天限额、每分钟请求数、并发、上游限流）。每分钟限流会带 Retry-After。

#响应字段

字段 类型 说明
object any
data array<object>
data[].id string 作为 model 发送的模型 ID。
data[].type string
data[].display_name string 已配置模型目前与 id 相同。
data[].created_at string Anthropic 风格条目才有；是固定的占位日期，不是发布日期。
data[].object string OpenAI 风格条目才有。
data[].owned_by string OpenAI 风格条目才有。

#示例

cURL
curl https://bigmodel.io/v1/models \
  -H "Authorization: Bearer $BIGMODEL_API_KEY"
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)
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)

已配置模型的分组的响应示例（具体 ID 取决于你的分组）：

json
{
  "object": "list",
  "data": [
    {"id": "glm-5.3", "type": "model", "display_name": "glm-5.3", "created_at": "2024-01-01T00:00:00Z"},
    {"id": "kimi-k3", "type": "model", "display_name": "kimi-k3", "created_at": "2024-01-01T00:00:00Z"}
  ]
}

#说明

  • 把 id 作为 model 使用。 对已配置的模型，display_name 与 id 相同，created_at 是固定占位值，不是发布日期。
  • 空列表或默认列表。 分组没有配置模型时，仅对话补全分组（DeepSeek、GLM 平台）返回空列表，其他分组可能返回该平台的内置默认列表。默认列表不代表分组真的提供这些模型。加上 ?configured_only=true 可以拿到空列表而不是默认列表。
  • 价格和介绍不在这个响应里，请看模型目录和模型 ID。
  • 余额为 0 时返回 403 INSUFFICIENT_BALANCE，即使列模型本身不收费。请到充值页面充值，或使用不需要余额的 GET /v1/usage。完整列表见错误码。

#相关文档

更新于 · 以 Markdown 查看