BigModel API 完整指南：接口格式、模型选择与接入流程

BigModel 是 bigmodel.org 提供的大模型 API 聚合平台。本站现有页面将其描述为统一的大模型接入入口，并提供 API 密钥、模型、钱包和使用日志等控制台入口。本文只说明当前站点可确认的基础接入方式：网关地址、认证、模型列表、聊天请求、响应读取和排查顺序。

BigModel API 的基础地址与接口

BigModel 的 API 网关地址为 https://api.bigmodel.org/。站内已有使用说明和 API 文档链接展示了 OpenAI 兼容风格的路径。

不要把示例中的模型名当作固定可用清单。平台线路和模型会调整，正式接入前应先调用 /v1/models，再使用本次响应中的真实模型 ID。

接入流程

1. 登录控制台并创建 API Key

打开 BigModel 控制台，在 API 密钥入口创建 Key。Key 是请求认证凭据，不应写入前端脚本或公开仓库；将它放在服务端环境变量或密钥管理服务中。

2. 先验证模型列表

在业务代码接入前，先用模型列表请求验证地址和认证。这样可以把网络、Key 与模型选择问题分开处理。

curl https://api.bigmodel.org/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

3. 从响应中选择模型

请求成功后，读取模型列表中返回的模型 ID，并将该 ID 放入后续请求的 model 字段。不要凭记忆或复制旧教程中的名称，以当前账号和当前响应为准。

4. 发起最小聊天请求

聊天接口使用 JSON 请求体，并要求同时携带认证头和 Content-Type: application/json。以下 MODEL_ID_FROM_MODELS 是占位符，必须替换为上一步真实返回的模型 ID。

curl https://api.bigmodel.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_MODELS",
    "messages": [
      {"role": "user", "content": "请用一句话介绍你自己。"}
    ],
    "stream": false
  }'

认证方式与请求格式

认证头

BigModel 使用 Bearer Token 认证。请求头格式为 Authorization: Bearer YOUR_API_KEY。如果缺少 Bearer、Key 无效或请求未携带认证头，接口无法完成身份校验。

聊天请求体

其他可选参数是否可用，取决于当前选择的模型和接口。先用最小请求跑通，再依据控制台、模型列表和当前 API 文档扩展参数。

响应结构怎么读取

模型列表与聊天接口都会返回 JSON。模型列表用于取得当前可调用的模型 ID；聊天请求成功后，再从聊天响应中读取生成内容。本站现有 Python 示例使用 response.choices[0].message.content 读取非流式聊天结果。

response = client.chat.completions.create(
    model="MODEL_ID_FROM_MODELS",
    messages=[{"role": "user", "content": "请总结这段文字。"}]
)
print(response.choices[0].message.content)

流式请求的返回会随生成过程分段到达，应按流式处理方式消费数据；非流式请求则在收到完整响应后读取内容。除上述已在站内示例使用的读取路径外，不应把未确认的字段或固定模型名称写死在业务逻辑中。

使用 OpenAI SDK 接入

BigModel 的调用风格与 OpenAI API 兼容。已有 OpenAI 风格项目可以先将 base_url 改为 https://api.bigmodel.org/v1，再传入 BigModel API Key 和模型列表返回的 ID。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.bigmodel.org/v1"
)

response = client.chat.completions.create(
    model="MODEL_ID_FROM_MODELS",
    messages=[{"role": "user", "content": "你好。"}]
)
print(response.choices[0].message.content)

常见问题

为什么先调用模型列表？

它可以同时确认 API Key、网关地址和可用模型。模型 ID 应以这次返回结果为准。

返回 401 应如何检查？

先检查 API Key 是否正确，认证头是否为 Authorization: Bearer YOUR_API_KEY，以及请求是否发送到包含 /v1 的正确网关地址。

聊天请求没有结果时从哪里排查？

先回到模型列表验证模型 ID，再检查 JSON 请求体与认证头；平台控制台提供使用日志入口，可用于核对调用记录和 Token 消耗。

可以直接复用 OpenAI 风格代码吗？

可以先按兼容方式替换 base_url 和 API Key，再用最小聊天请求验证。模型能力和可选参数仍应以当前模型和文档为准。

小结

BigModel 的基础接入顺序是：创建 API Key，调用 /v1/models 取得真实模型 ID，再向 /v1/chat/completions 发送最小 JSON 请求。这样可以先验证认证和路由，再进入具体模型、流式输出或业务功能的调试。