Home >博客

BigModel AI 使用说明:一个 API 接入全球主流大模型

Published Updated

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 消耗。

FAQ

BigModel AI 和 GPT、Claude、Gemini 是什么关系?
BigModel AI 是聚合和转发平台,GPT、Claude、Gemini 等是上游模型品牌,平台提供统一的账号、网关和管理入口。
调用 API 前需要准备什么?
需要登录 BigModel 控制台创建 API Key,确认钱包中有可用额度,并先通过 /v1/models 获取当前可用的模型 ID。
如何发起第一条对话请求?
在 https://api.bigmodel.org/v1/chat/completions 发送带 Authorization: Bearer API Key 的 JSON 请求,并将 model 设置为模型列表返回的真实 ID。
为什么不能直接填写记忆中的模型名?
模型和线路会调整,能否调用取决于当前账号和渠道,因此应先请求 /v1/models,再使用返回的模型 ID。
调用返回 401 如何排查?
检查 API Key 是否完整、Authorization 头格式是否正确、base_url 是否包含 /v1,并确认账号状态和额度正常。

目录

信息

  • 点击6
  • 发布日期2026/08/31
0/500
友善分享您的看法。

更多帖子

探索本节更多文章