Skip to content

LobeChat、NextChat 接入第三方 API ​

两个工具的地址填法正好相反:LobeChat 的「API 代理地址」填 https://hivegpt.cn/v1,NextChat 的 BASE_URL / 接口地址填 https://hivegpt.cn(不带 /v1)。 两者都让请求经过它自己的服务器转发:LobeChat 不要打开「使用客户端请求模式」,NextChat 自建时用环境变量配置地址,界面里的接口地址保持默认。

更新于 2026-10,基于 LobeHub 2.x 和 NextChat 当前版本。

准备 ​

一个 HiveGPT 的 API Key:在 API 密钥 页创建,分组选 GPT 类分组。还没有账号先 注册。

为什么不能让浏览器直接请求

两个工具都有「浏览器直接请求接口」的模式。HiveGPT 的接口不接受网页里的跨域请求,所以要让请求经过 LobeChat / NextChat 自己的服务器转发(这也是它们的默认方式),Key 也不会暴露在网页里。

一、LobeChat(LobeHub) ​

在界面里配置 ​

  1. 打开 应用设置 → AI 服务商,选 OpenAI,打开这个服务商。
  2. 填写:
字段填什么
API Key你的 HiveGPT Key
API 代理地址https://hivegpt.cn/v1(要带 /v1)
使用客户端请求模式关闭
  1. 在 连通性检查 里点 检查。
  2. 在 模型列表 里点 获取模型列表,打开要用的模型;没有的话点 添加模型,模型 ID 填 gpt-5.5,最大上下文窗口填 1050000,打开「支持视觉识别」和「支持技能使用」。
  3. 回到对话,在模型选择里选 OpenAI 下的 gpt-5.5。

也可以用 创建自定义 AI 服务商(请求格式选 openai,代理地址填 https://hivegpt.cn/v1),和官方 OpenAI 分开管理。

自己部署时用环境变量 ​

LobeHub 2.x 自建需要 PostgreSQL 数据库和几项密钥(DATABASE_URL、KEY_VAULTS_SECRET、AUTH_SECRET 等),完整步骤见 LobeHub 官方部署文档。和 HiveGPT 相关的是这三个变量:

bash
OPENAI_API_KEY=sk-你的Key
OPENAI_PROXY_URL=https://hivegpt.cn/v1
OPENAI_MODEL_LIST=-all,+gpt-5.5=GPT-5.5

OPENAI_MODEL_LIST 里 -all 隐藏所有内置模型,+ 添加模型,= 后面是显示名称。

二、NextChat(ChatGPT-Next-Web) ​

自己部署(推荐) ​

用环境变量配置,请求由 NextChat 的服务器转发:

bash
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=sk-你的Key \
  -e BASE_URL=https://hivegpt.cn \
  -e CUSTOM_MODELS=-all,+gpt-5.5 \
  -e DEFAULT_MODEL=gpt-5.5 \
  -e CODE=设置一个访问密码 \
  -e HIDE_USER_API_KEY=1 \
  yidadaa/chatgpt-next-web
变量作用
BASE_URLhttps://hivegpt.cn,不要带 /v1,NextChat 会自己加
OPENAI_API_KEY你的 HiveGPT Key
CUSTOM_MODELS-all 隐藏内置模型,+gpt-5.5 添加模型,多个用英文逗号隔开
DEFAULT_MODEL默认模型
CODE访问密码,多个用逗号隔开。不设的话任何人打开网址都能用你的 Key
HIDE_USER_API_KEY设为 1 时用户不能填自己的 Key

部署到 Vercel 时,在项目的环境变量里设置同样的变量。

打开 http://服务器地址:3000,在设置里输入访问密码就能用。

在界面里配置 ​

已经部署好的 NextChat,也可以在 设置 → 自定义接口 里填:

字段填什么
模型服务商OpenAI
接口地址保持默认,用服务器上配置的 BASE_URL
API Key你的 HiveGPT Key
自定义模型名gpt-5.5,多个用英文逗号隔开

接口地址改成 https://hivegpt.cn 时会变成浏览器直接请求,在网页版里会因为跨域被拦下;用服务器端的 BASE_URL 就没有这个问题。

常见问题 ​

现象原因处理
LobeChat 回复是空的API 代理地址少了 /v1改成 https://hivegpt.cn/v1
NextChat 报 404,提示「接口地址多了一个 /v1」BASE_URL 带了 /v1改成 https://hivegpt.cn
网页里报跨域错误、Failed to fetch开了浏览器直接请求LobeChat 关闭「使用客户端请求模式」;NextChat 接口地址保持默认
NextChat 报 403「you are not allowed to use X model」模型不在 CUSTOM_MODELS 里在 CUSTOM_MODELS 里加上
401Key 不对或已停用见 401 报错
提示分组「不支持模型」模型名不在你的分组里见 模型不存在
余额很快用完网址被别人用了NextChat 设置 CODE 访问密码;给这个 Key 设额度上限

自己用、不想部署的话,桌面客户端更简单,见 Cherry Studio、Chatbox。

代码示例在页面里运行时使用 HiveGPT 的模型接口。延伸阅读来自 JavaGuide(Apache-2.0),版权归原作者。