API 快速开始

BigModel.io 用一个 API Key 接入领先的大模型。接口同时支持 OpenAI 和 Anthropic 两种协议，大多数 SDK 和工具使用其中一种，通常只需要改 Base URL 和 Key。目前可用的模型包括 GLM、DeepSeek、Kimi、MiniMax 和豆包，见模型目录。

认证方式为 Authorization: Bearer $BIGMODEL_API_KEY；发送 x-api-key 请求头的 Anthropic 客户端同样可用。

#1. 选择模型

在 模型目录 打开模型详情，记下模型 ID、价格和支持的端点。模型 ID 小写且保留点号，例如 glm-5.3、deepseek-v4-pro。聊天、图像和视频接口的请求结构各不相同。

浏览模型 →

#2. 创建 API Key

登录控制台，在 API Keys 中选择能提供目标模型的分组并创建 Key。分组决定 Key 可用的模型、端点以及扣费倍率；不同分组的 Key 不能互换。

完整 Key 随时可以在 API Keys 中查看和复制，不必在创建时立刻保存。请把它放在服务端环境变量里，不要写进网页前端代码或公开仓库。

export BIGMODEL_API_KEY="sk-..."

打开 API Keys →

#3. 充值余额

请求按美元从余额中扣费，调用付费模型时余额需大于 0。GET /v1/models 同样需要余额大于 0：余额为 0 时返回 403 INSUFFICIENT_BALANCE。注册即赠送试用额度，金额以控制台显示为准；标价 $0 的模型在余额为 0 时也能调用。可以在充值页面充值；如果 Key 属于套餐分组，也可以使用套餐。见 计费与充值 和 试用额度与免费模型。

前往充值 → · 价格

#4. 发送请求

把 glm-5.3 换成 Key 所在分组提供的模型 ID。

curl https://bigmodel.io/v1/chat/completions \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","messages":[{"role":"user","content":"你好！"}]}'

import os
from openai import OpenAI

client = OpenAI(base_url="https://bigmodel.io/v1", api_key=os.environ["BIGMODEL_API_KEY"])
resp = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "你好！"}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://bigmodel.io/v1", apiKey: process.env.BIGMODEL_API_KEY });
const resp = await client.chat.completions.create({
  model: "glm-5.3",
  messages: [{ role: "user", content: "你好！" }],
});
console.log(resp.choices[0].message.content);

在提供 /v1/messages 的分组上，Anthropic Messages 协议的用法相同：

curl https://bigmodel.io/v1/messages \
  -H "Authorization: Bearer $BIGMODEL_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-5.3","max_tokens":64,"messages":[{"role":"user","content":"你好！"}]}'

若客户端要求填写 Base URL，OpenAI 类客户端需要末尾的 /v1（https://bigmodel.io/v1）；若要求完整请求 URL，则填写完整端点，避免重复添加 /v1。Anthropic 客户端例外：填 https://bigmodel.io，客户端会自己拼上 /v1/messages。

SDK 代码见 OpenAI SDK 与 LangChain；编程工具见 Claude Code、Cursor、Codex CLI、OpenCode 和 Cline。视频生成是异步任务，见 视频 API 指南。

#验证配置

列出 Key 能调用的模型。如果返回为空或 403，问题通常在分组或余额。

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

然后打开 用量：刚才的测试请求应显示模型、Token 和实际费用。GET /v1/usage 会返回同样的汇总以及该 Key 的剩余余额。

#常见问题排查

401 API_KEY_REQUIRED 或 INVALID_API_KEY。 Key 缺失或填错。请用 Authorization: Bearer sk-...（或 x-api-key）发送，不要放在 URL 里；?key= 会返回 400 api_key_in_query_deprecated。

401 API_KEY_DISABLED 或 403 API_KEY_EXPIRED。 在 API Keys 中启用 Key 或延长有效期。

403 INSUFFICIENT_BALANCE。 余额为 0 或已为负。充值 后重试。GET /v1/models 同样受影响。

503 No available accounts: no available accounts supporting model: ...。 模型 ID 拼错，或 Key 所在分组不提供该模型。BigModel.io 对未知模型返回这个 503，而不是 404。请从 /models 复制 ID，并用 GET /v1/models 核对。

404 ... platform only supports /v1/chat/completions。 Key 所在分组只提供 Chat Completions。改用 /v1/chat/completions，或换一个提供 Messages / Responses 的分组的 Key。

429。 触发了 Key 额度、消费窗口、套餐限额或速率限制，错误码会说明是哪一种；见 限额与速率。

超时或 5xx。 退避后重试。记下响应头 X-Request-ID 和请求时间。视频任务超时后可能仍在运行，先查询状态再决定是否重新提交。完整列表见 错误码。

#仍需要帮助？

打开 支持，附上模型 ID、接口路径、请求时间、HTTP 状态码、错误信息和 X-Request-ID。请先移除 API Key 和敏感输入。也可以发邮件到 support@bigmodel.io。

#相关文档

• 认证与 API Key
• 计费与充值
• 错误码
• 常见问题