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 详情页随时重新查看)。
在界面里配置#
- 应用设置 → AI 服务商 → OpenAI
- 填:
- API Key: 你的
sk-gpushare-... - API 代理地址:
https://qd.zsopc.com/v1(要带/v1)
- API Key: 你的
- 使用客户端请求模式 保持关闭(原因见下方「注意事项」)
- 点 检查 测试连通,再用 获取模型列表 拉取模型,或 添加模型 手动填模型 ID(如
claude-sonnet-4-6、gpt-6.1-sol、deepseek-v4.1-flash)
想把本平台单独列成一个服务商,用 添加自定义服务商:服务商 ID(建好后不能改)、服务商名称 随意,请求格式 与 代理地址 按下表填,API Key 填同一把 Key。
| 请求格式 | 代理地址 | 适合的模型 |
|---|---|---|
| OpenAI | https://qd.zsopc.com/v1 | 全部文本模型 |
| Anthropic | https://qd.zsopc.com(不带 /v1) | Claude 系列 |
https://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_key | Key 是否复制完整(共 76 字符);可在 Key 详情页 重新查看 |
| 检查失败 / 回复为空 | OpenAI 代理地址应为 https://qd.zsopc.com/v1;Anthropic / Google 格式不要带版本号 |
400 model_not_found | 模型 ID 拼写,须与 模型列表 一致 |
402 quota_exceeded | 余额不足。所有 Key 共享同一账户余额,到 充值页 充值 |
| 浏览器报跨域 / 网络错误 | 关闭「客户端请求模式」 |
错误码完整说明见 错误码。
其他客户端#
- NextChat — 轻量网页对话
- Open WebUI — 自托管 ChatGPT 风格界面
- Cherry Studio — 桌面客户端
- Chatbox — 桌面 / 手机客户端