LobeChat 集成

LobeChat(现名 LobeHub)在界面里或用自托管环境变量接入本平台,OpenAI / Anthropic / Gemini 三种请求格式都可用

LobeChat 现已更名 LobeHub,是开源、可自托管的 AI 对话应用。本页步骤按 LobeHub v2.3.3(2026-11-12 发布)的界面文案与官方文档核对。

准备 API Key#

在 qd.zsopc.com/dashboard/keys 创建 API Key(sk-gpushare- + 64 位十六进制,创建后可在 Key 详情页随时重新查看)。

在界面里配置#

  1. 应用设置 → AI 服务商 → OpenAI
  2. 填:
    • API Key: 你的 sk-gpushare-...
    • API 代理地址: https://qd.zsopc.com/v1(要带 /v1)
  3. 使用客户端请求模式 保持关闭(原因见下方「注意事项」)
  4. 点 检查 测试连通,再用 获取模型列表 拉取模型,或 添加模型 手动填模型 ID(如 claude-sonnet-4-6、gpt-6.1-sol、deepseek-v4.1-flash)

想把本平台单独列成一个服务商,用 添加自定义服务商:服务商 ID(建好后不能改)、服务商名称 随意,请求格式 与 代理地址 按下表填,API Key 填同一把 Key。

请求格式代理地址适合的模型
OpenAIhttps://qd.zsopc.com/v1全部文本模型
Anthropichttps://qd.zsopc.com(不带 /v1)Claude 系列
Googlehttps://qd.zsopc.com(不带 /v1beta)Gemini 系列

只用 OpenAI 请求格式也能调 Claude / Gemini 模型,网关会自动做协议翻译,见 兼容矩阵。

自托管:用环境变量配置#

自托管时可以在服务端用环境变量预置服务商,用户无需各自填 Key:

OPENAI_API_KEY=sk-gpushare-xxx
OPENAI_PROXY_URL=https://qd.zsopc.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6,+gpt-6.1-sol,+deepseek-v4.1-flash

# 可选:Claude / Gemini 走原生协议
ANTHROPIC_API_KEY=sk-gpushare-xxx
ANTHROPIC_PROXY_URL=https://qd.zsopc.com
GOOGLE_API_KEY=sk-gpushare-xxx
GOOGLE_PROXY_URL=https://qd.zsopc.com

OPENAI_MODEL_LIST 里 -all 隐藏内置模型,+id 添加一个模型。数据库、鉴权、对象存储等其余变量按官方的 Docker 部署文档 配置(镜像 lobehub/lobehub,端口 3210)。

注意事项#

  • 客户端请求模式:打开后请求从浏览器直接发往 API,而本平台的 API 不对第三方网页开放跨域访问,会失败。保持关闭,让 LobeHub 的服务端转发即可。
  • 使用 Responses API 规范:打开后改走 /v1/responses,只有部分模型支持(见 兼容矩阵);混用多家模型时建议保持关闭。
  • 获取模型列表 拉到的是这把 Key 能调用的全部模型,其中图像、视频等模型不能在对话里用。
  • 回复为空时,先检查 OpenAI 的代理地址有没有带 /v1。

常见问题#

现象排查
401 invalid_api_keyKey 是否复制完整(共 76 字符);可在 Key 详情页 重新查看
检查失败 / 回复为空OpenAI 代理地址应为 https://qd.zsopc.com/v1;Anthropic / Google 格式不要带版本号
400 model_not_found模型 ID 拼写,须与 模型列表 一致
402 quota_exceeded余额不足。所有 Key 共享同一账户余额,到 充值页 充值
浏览器报跨域 / 网络错误关闭「客户端请求模式」

错误码完整说明见 错误码。

其他客户端#