# 在 LobeChat 中使用 BigModel.io

> 通过设置界面，或在自托管时设置环境变量 OPENAI_PROXY_URL=https://bigmodel.io/v1 和 OPENAI_MODEL_LIST，把 LobeChat（LobeHub）接到 BigModel.io，并排查常见报错。

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

LobeChat（现名 LobeHub）可以把 BigModel.io 设为 OpenAI 服务商、自定义服务商，或在自托管实例中通过环境变量接入。三种方式都在 `https://bigmodel.io/v1` 上使用 OpenAI 请求格式。

| 配置项 | 值 |
|---|---|
| API Key | 你的 BigModel.io API Key（`sk-...`） |
| 代理地址（OpenAI 格式） | `https://bigmodel.io/v1` |
| 代理地址（Anthropic 格式） | `https://bigmodel.io`（不带 `/v1`） |
| 模型 | [模型目录](https://bigmodel.io/zh-cn/models)中的模型 ID |

## 方式一：设置界面

1. 打开 **设置 → AI 服务商**（Settings → AI Providers）。
2. 打开 **OpenAI**，或选择 **创建自定义 AI 服务商**，服务商 ID 填 `bigmodel` 之类，请求格式选 **openai**。
3. 填入 [API Keys](https://bigmodel.io/keys) 中的 Key，**代理地址**填 `https://bigmodel.io/v1`。
4. 点击 **检查** 测试连接。
5. 添加或启用需要的模型，使用准确的 ID，如 `glm-5.3`、`kimi-k3`、`deepseek-v4-pro`。

用自定义服务商可以不占用 OpenAI 自身的配置。请求格式选 **anthropic**、代理地址填 `https://bigmodel.io` 也可以，但只适用于分组支持 `/v1/messages` 的 Key。

## 方式二：自托管环境变量

自托管实例可以在 `.env` 或容器环境中设置：

```bash
OPENAI_API_KEY=sk-your-bigmodel-key
OPENAI_PROXY_URL=https://bigmodel.io/v1
OPENAI_MODEL_LIST="-all,+glm-5.3=GLM-5.3<128000:fc>,+kimi-k3=Kimi K3<128000:fc>,+deepseek-v4-pro=DeepSeek V4 Pro<128000:fc>"
```

`OPENAI_MODEL_LIST` 语法：

- `-all` 隐藏内置的 OpenAI 模型，BigModel.io 不提供这些模型。
- `+id=显示名称` 添加模型，`id` 必须是目录中的准确 ID。
- `<maxToken:vision:reasoning:search:fc:file>` 声明上下文长度和能力。只有支持工具调用的模型才加 `fc`，支持图片输入才加 `vision`。上面的 `128000` 只是占位，请按各模型页填写上下文窗口。

如果用 Anthropic 格式，改为设置 `ANTHROPIC_API_KEY` 和 `ANTHROPIC_PROXY_URL=https://bigmodel.io`。修改环境变量后重启容器。

## 验证配置

新建对话，在模型选择器中选一个 BigModel.io 模型，发送 "ping"。应收到回复，并在[用量](https://bigmodel.io/usage)页看到这条请求。

## 常见问题排查

**检查失败，返回 403 `INSUFFICIENT_BALANCE`。** 余额为 0 或以下，到[充值页](https://bigmodel.io/purchase)充值。

**检查失败，提示默认模型不可用。** LobeChat 可能用内置 OpenAI 模型名做检查，而你的分组不提供该模型（503 `api_error`：`No available accounts ...`）。先添加自己的模型，选它来检查，再试一次。

**所有请求都返回 404。** 代理地址错了。OpenAI 格式要 `https://bigmodel.io/v1`，Anthropic 格式要 `https://bigmodel.io`。

**404 `not_found_error`：`... /v1/messages is not available`。** 选了 Anthropic 格式，但 Key 来自仅支持 Chat Completions 的分组（GLM 或 DeepSeek）。改用 openai 格式。

**仍然显示内置 GPT 模型。** `OPENAI_MODEL_LIST` 没有以 `-all` 开头，或容器没有重启。

**401 `INVALID_API_KEY`。** Key 带了空格、已被删除，或 `OPENAI_API_KEY` 里还是 OpenAI 的 Key。

## 相关文档

- [Cherry Studio](https://bigmodel.io/zh-cn/docs/cherry-studio)：桌面对话客户端。
- [Dify](https://bigmodel.io/zh-cn/docs/dify)：搭建应用和工作流。
- [工具调用](https://bigmodel.io/zh-cn/docs/tool-calling) 和[图片输入](https://bigmodel.io/zh-cn/docs/vision)：该声明哪些能力。