在 LobeChat 中使用 BigModel.io

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

本页目录
  1. 方式一：设置界面
  2. 方式二：自托管环境变量
  3. 验证配置
  4. 常见问题排查
  5. 相关文档

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）
模型 模型目录中的模型 ID

#方式一：设置界面

  1. 打开 设置 → AI 服务商（Settings → AI Providers）。
  2. 打开 OpenAI，或选择 创建自定义 AI 服务商，服务商 ID 填 bigmodel 之类，请求格式选 openai。
  3. 填入 API 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"。应收到回复，并在用量页看到这条请求。

#常见问题排查

检查失败，返回 403 INSUFFICIENT_BALANCE。 余额为 0 或以下，到充值页充值。

检查失败，提示默认模型不可用。 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。

#相关文档

更新于 · 以 Markdown 查看