# LobeChat 集成

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

来源：https://qd.zsopc.com/docs/integrations/lobechat

> [LobeChat](https://github.com/lobehub/lobehub) 现已更名 **LobeHub**,是开源、可自托管的 AI 对话应用。本页步骤按 LobeHub v2.3.3(2026-11-12 发布)的界面文案与[官方文档](https://github.com/lobehub/lobehub/tree/main/docs)核对。

## 准备 API Key

在 [qd.zsopc.com/dashboard/keys](https://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。

| 请求格式 | 代理地址 | 适合的模型 |
|---|---|---|
| OpenAI | `https://qd.zsopc.com/v1` | 全部文本模型 |
| Anthropic | `https://qd.zsopc.com`(不带 `/v1`) | Claude 系列 |
| Google | `https://qd.zsopc.com`(不带 `/v1beta`) | Gemini 系列 |

只用 OpenAI 请求格式也能调 Claude / Gemini 模型,网关会自动做协议翻译,见 [兼容矩阵](../reference/compatibility-matrix.md)。

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

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

```bash
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 部署文档](https://github.com/lobehub/lobehub/blob/main/docs/self-hosting/platform/docker.mdx) 配置(镜像 `lobehub/lobehub`,端口 3210)。

## 注意事项

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

## 常见问题

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

错误码完整说明见 [错误码](../reference/errors.md)。

## 其他客户端

- [NextChat](./nextchat.md) — 轻量网页对话
- [Open WebUI](./open-webui.md) — 自托管 ChatGPT 风格界面
- [Cherry Studio](./cherry-studio.md) — 桌面客户端
- [Chatbox](./chatbox.md) — 桌面 / 手机客户端
