# 在 Cherry Studio 中使用 BigModel.io

> 在 Cherry Studio 中把 BigModel.io 添加为 OpenAI 类型的自定义服务商，API 地址填 https://bigmodel.io，获取 GLM、Kimi、DeepSeek 等模型并检查连接。

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

Cherry Studio 是支持自定义模型服务商的桌面对话客户端。把 BigModel.io 添加为 **OpenAI** 类型的服务商后，它会调用 Chat Completions，所有文本分组都支持。

| Cherry Studio 中的字段 | 值 |
|---|---|
| 提供商类型 | OpenAI |
| API 密钥 | 你的 BigModel.io API Key（`sk-...`） |
| API 地址 | `https://bigmodel.io`（Cherry Studio 会自动拼上 `/v1/chat/completions`） |
| 模型 | [模型目录](https://bigmodel.io/zh-cn/models)中的模型 ID，如 `glm-5.3` |

和大多数工具不同，这里 OpenAI 类型的地址是**不带** `/v1` 的根地址。填成 `https://bigmodel.io/v1` 时，请求会发到 `/v1/v1/chat/completions`。

## 添加服务商

1. 打开 **设置 → 模型服务**。
2. 点击 **+ 添加**，填写名称（如 `BigModel.io`），提供商类型选 **OpenAI**。
3. 把 [API Keys](https://bigmodel.io/keys) 中的 Key 粘贴到 **API 密钥**。多个 Key 可用英文逗号分隔。
4. **API 地址** 填 `https://bigmodel.io`。
5. 添加模型：点击 **获取模型列表**，添加需要的模型；或点 **+** 手动输入准确的模型 ID，如 `glm-5.3`。只有添加过的模型才会出现在对话的模型选择中。
6. 打开该服务商的开关。

如果要原样使用完整地址，可以在末尾加 `#`，例如 `https://bigmodel.io/v1/chat/completions#`。一般不需要这样做。

## 验证配置

点击 API 密钥旁的 **检查**，选一个已添加的模型，确认检查通过。再用这个模型开始对话，在[用量](https://bigmodel.io/usage)页确认出现这条请求。

## 常见问题排查

**检查失败，返回 404。** 地址带了 `/v1` 或完整路径。OpenAI 类型请填 `https://bigmodel.io`。

**模型列表为空，或获取时返回 403 `INSUFFICIENT_BALANCE`。** 获取模型列表需要余额大于 0。到[充值页](https://bigmodel.io/purchase)充值，或用 **+** 手动添加模型。

**503 `api_error`：`No available accounts: no available accounts supporting model: ...`。** 添加的模型 ID 拼错，或 Key 所在分组不提供该模型。请从模型页复制 ID。

**401 `INVALID_API_KEY`。** Key 带了空格或已被删除，到 [API Keys](https://bigmodel.io/keys) 重新复制。

**对话里选不到某个模型。** 只有添加过的模型才会出现，在服务商的模型列表中添加即可。

**429 `API_KEY_QUOTA_EXHAUSTED` 或 `rate_limit_exceeded`。** Key 的额度或 5 小时 / 1 天 / 7 天消费窗口已用完。到 [API Keys](https://bigmodel.io/keys) 提高或重置，或等窗口结束。

## 相关文档

- [LobeChat](https://bigmodel.io/zh-cn/docs/lobechat)：可自托管的网页对话客户端。
- [CC Switch](https://bigmodel.io/zh-cn/docs/cc-switch)：在不同服务商之间切换编程工具。
- [认证与 API Key](https://bigmodel.io/zh-cn/docs/authentication)：Key 与分组的工作方式。