# API 快速开始

> 向全球大模型 API 平台 BigModel.io 发送第一个请求：选择模型、创建 API Key，通过 OpenAI 或 Anthropic 兼容接口调用。

网页版: https://bigmodel.io/zh-cn/docs/quickstart · 更新于 2026-10-18

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

| 协议 | 需要填写的 Base URL | 客户端实际调用的端点 |
|---|---|---|
| OpenAI 兼容 | `https://bigmodel.io/v1` | `/v1/chat/completions`、`/v1/responses`、`/v1/models` |
| Anthropic 兼容 | `https://bigmodel.io` | `/v1/messages`（客户端会自己加 `/v1`） |

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

## 1. 选择模型

在 [模型目录](https://bigmodel.io/zh-cn/models) 打开模型详情，记下模型 ID、价格和支持的端点。模型 ID 小写且保留点号，例如 `glm-5.3`、`deepseek-v4-pro`。聊天、图像和视频接口的请求结构各不相同。

[浏览模型 →](https://bigmodel.io/zh-cn/models)

## 2. 创建 API Key

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

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

```bash
export BIGMODEL_API_KEY="sk-..."
```

[打开 API Keys →](https://bigmodel.io/keys)

## 3. 充值余额

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

[前往充值 →](https://bigmodel.io/purchase) · [价格](https://bigmodel.io/zh-cn/pricing)

## 4. 发送请求

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

```bash [cURL]
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":"你好！"}]}'
```

```python [Python]
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)
```

```js [Node.js]
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 协议的用法相同：

```bash
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](https://bigmodel.io/zh-cn/docs/openai-sdk-langchain)；编程工具见 [Claude Code](https://bigmodel.io/zh-cn/docs/claude-code)、[Cursor](https://bigmodel.io/zh-cn/docs/cursor)、[Codex CLI](https://bigmodel.io/zh-cn/docs/codex-cli)、[OpenCode](https://bigmodel.io/zh-cn/docs/opencode) 和 [Cline](https://bigmodel.io/zh-cn/docs/cline)。视频生成是异步任务，见 [视频 API 指南](https://bigmodel.io/zh-cn/docs/video-generation)。

## 验证配置

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

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

然后打开 [用量](https://bigmodel.io/usage)：刚才的测试请求应显示模型、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](https://bigmodel.io/keys) 中启用 Key 或延长有效期。

**403 `INSUFFICIENT_BALANCE`。** 余额为 0 或已为负。[充值](https://bigmodel.io/purchase) 后重试。`GET /v1/models` 同样受影响。

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

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

**429。** 触发了 Key 额度、消费窗口、套餐限额或速率限制，错误码会说明是哪一种；见 [限额与速率](https://bigmodel.io/zh-cn/docs/rate-limits)。

**超时或 5xx。** 退避后重试。记下响应头 `X-Request-ID` 和请求时间。视频任务超时后可能仍在运行，先查询状态再决定是否重新提交。完整列表见 [错误码](https://bigmodel.io/zh-cn/docs/errors)。

## 仍需要帮助？

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

## 相关文档

- [认证与 API Key](https://bigmodel.io/zh-cn/docs/authentication)
- [计费与充值](https://bigmodel.io/zh-cn/docs/billing)
- [错误码](https://bigmodel.io/zh-cn/docs/errors)
- [常见问题](https://bigmodel.io/zh-cn/docs/faq)