BigModel AI 使用说明:一个 API 接入全球主流大模型
BigModel AI API Guide
BigModel AI 是 bigmodel.org 提供的大模型 API 聚合服务。它是统一的接入平台,而不是某一个上游大模型;开发者通过一个控制台和 API Key 访问平台当前可用的模型,再按实际模型能力发起请求。
平台与产品的关系
BigModel 是平台品牌和 API 接入服务。官网展示了 OpenAI、Anthropic、Google、DeepSeek 等主流模型接入信息,并提供模型、渠道、API 密钥、钱包和使用日志等后台入口。
当应用向 BigModel 网关发起请求时,实际的回答、生成或向量计算由所选的上游模型完成;BigModel 负责统一的访问入口、Key 和使用记录管理。可用模型会随线路调整,因此正式接入时应以模型列表接口返回的模型 ID 为准。
核心能力与适用场景
统一 API 入口
网关地址为 https://api.bigmodel.org/,请求风格兼容常见的 OpenAI API 调用方式。
多类 API 请求
站点示例包含模型列表、聊天、Embedding、图像生成和语音转写等接口。具体能力取决于当前选用的模型。
已有项目切换
已使用 OpenAI 风格 SDK 的项目,可先替换 base_url 和 API Key,以最小请求验证模型和线路。
统一查看记录
测试完成后,可在控制台的使用日志中核对请求记录和 Token 消耗。
快速开始
1. 创建 API Key
登录 BigModel 控制台,在 API 密钥(令牌)页面创建 Key。Key 不应写入前端代码或公开仓库,应通过环境变量或服务端密钥管理方式保存。
2. 读取当前可用模型
先请求模型列表,再从返回内容中复制模型 ID。示例中的 Key 和模型名均为占位符:
curl https://api.bigmodel.org/v1/models \
-H "Authorization: Bearer YOUR_API_KEY" 3. 发起第一条聊天请求
把 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": "你好,请用一句话介绍你自己。"}
]
}' 4. 在 OpenAI SDK 中配置
将客户端 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) 参数说明
- base_url
- OpenAI 兼容 SDK 使用
https://api.bigmodel.org/v1。 - Authorization
- 请求头格式为
Bearer YOUR_API_KEY。 - model
- 使用
/v1/models返回的真实模型 ID。 - messages
- 聊天消息数组,至少包含一条 user 消息;其他参数以当前模型和接口实际支持为准。
常见问题
BigModel AI 与 GPT、Claude、Gemini 是什么关系?
BigModel AI 是聚合和转发平台,GPT、Claude、Gemini 等是上游模型品牌。平台提供统一的账号、网关和管理入口。
为什么不能直接填写记忆中的模型名?
模型和线路会调整,能否调用取决于当前账号和渠道。应先请求 /v1/models,再使用返回的模型 ID。
调用返回 401 如何排查?
检查 API Key、Authorization: Bearer 请求头、包含 /v1 的 base_url,以及账号状态和额度。
如何确认请求经过 BigModel?
确认客户端收到接口响应后,可在控制台的使用日志页面核对对应请求和 Token 消耗。

