LobeChat 配置中转 API 教程 2026：国内直连 Claude / GPT / Gemini 全家桶

LobeChat 是我日常测试大模型 API 时最常用的开源聊天客户端之一，界面友好、支持多模型、配置灵活。对于国内用户来说，直接接 OpenAI、Claude 或 Gemini 官方 API 往往会遇到网络、支付、额度和模型切换麻烦的问题，所以更适合接入兼容 OpenAI 格式的中转 API。本文以 LobeChat 配置中转 API 为例，演示如何接入块乐 Encore API，并简单对比我测试过的多家 API 服务体验。

一、为什么用 LobeChat 配置中转 API？

我前后测试过 5 家以上 API 服务，包括官方 API、部分海外聚合平台、国内中转平台和私有代理方案。综合来看，新手最容易卡在三个地方：网络不稳定、模型名不统一、Key 配置不清楚。

LobeChat 的优势是配置入口清晰，支持自定义 Base URL 和模型名；而中转 API 的优势是可以把 Claude、GPT、Gemini 等模型统一到一个接口里调用。本文使用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后即可获取 API Key。

二、下载安装 LobeChat

LobeChat 支持多种使用方式，新手建议先用网页或 Docker 版本。

方式一：直接使用网页版

如果只是测试 API，最简单的方式是打开 LobeChat 官方在线版本，进入后直接配置即可。

适合人群：

• 不想折腾部署
• 只想快速测试模型
• 临时验证 API Key 是否可用

方式二：Docker 本地部署

如果你希望数据在本地保存，可以使用 Docker 部署：

docker run -d \
  --name lobechat \
  -p 3210:3210 \
  lobehub/lobe-chat

启动后，在浏览器访问：

http://localhost:3210

如果能看到 LobeChat 首页，说明安装完成。

三、打开 LobeChat 设置入口

进入 LobeChat 后，按下面步骤操作：

1. 点击左下角头像或设置图标
2. 进入「设置」
3. 找到「语言模型」或「模型服务商」
4. 选择 OpenAI / OpenAI Compatible / 自定义 OpenAI 接口
5. 准备填写 Base URL、API Key 和模型名称

不同版本的 LobeChat 菜单名称可能略有差异，但核心就是找到“自定义 OpenAI 兼容接口”。

四、配置中转 API 参数

这里用的是 块乐 Encore 的 API，国内直连，支持 Claude / GPT / Gemini 全家桶，在 https://stillhappy.cn 注册后获取 key。

在 LobeChat 中填写以下参数：

Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxx
模型名: claude-sonnet-4-6

你也可以根据需要切换其他模型，例如：

模型名: gpt-5
模型名: gemini-2.5-pro
模型名: claude-sonnet-4-6

完整示例：

{
  "base_url": "https://api-ic.stillhappy.cn/v1",
  "api_key": "sk-xxx",
  "model": "claude-sonnet-4-6"
}

注意事项：

• API Key 必须填写你在 Encore 后台生成的真实 key
• Base URL 不要漏掉 /v1
• 模型名要和平台支持的名称完全一致
• 如果 LobeChat 有“自定义模型列表”，建议手动添加模型名

五、测试是否接入成功

配置完成后，回到 LobeChat 主界面，新建一个对话。

建议先用简单问题测试：

请用一句话介绍你自己。

如果模型正常回复，说明 LobeChat 已成功接入中转 API。

然后可以继续测试更复杂的任务，例如：

请帮我写一个 Python requests 调用 OpenAI 兼容接口的示例。

如果你配置的是 claude-sonnet-4-6，可以测试长文总结、代码解释等任务；如果配置的是 gemini-2.5-pro，可以测试多语言理解和长上下文；如果配置的是 gpt-5，可以测试通用问答、代码生成和复杂推理。

六、我测试过的 API 服务对比：哪类更适合新手？

从实际体验看，不同 API 方案适合的人群不一样：

如果只是想在 LobeChat 里快速用上 Claude、GPT、Gemini，我更推荐先用兼容 OpenAI 格式的中转 API，配置成本最低。

七、常见问题排查

1. 报错 401 Unauthorized 怎么办？

401 通常是 API Key 错误。请检查：

• Key 是否完整复制
• 是否包含多余空格
• 是否使用了正确平台的 Key
• LobeChat 中是否填在 API Key 字段，而不是模型名字段

示例格式：

API Key: sk-xxx

2. 提示余额不足怎么办？

如果返回余额不足、quota exceeded、insufficient balance 等信息，说明账户额度不够。进入 Encore 后台查看余额或充值后再测试。

3. 模型名错误怎么办？

模型名必须和平台支持的名称一致。例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

不要写成 Claude Sonnet 4.6、GPT5 或 gemini pro，否则可能会返回 model not found。

4. Base URL 填错怎么办？

Base URL 建议填写：

https://api-ic.stillhappy.cn/v1

常见错误包括：

https://api-ic.stillhappy.cn
https://api-ic.stillhappy.cn/v1/

部分客户端对末尾斜杠不敏感，但新手建议严格按文档填写。

5. LobeChat 没有显示自定义模型怎么办？

可以进入模型设置，手动添加模型 ID，例如：

claude-sonnet-4-6
gpt-5
gemini-2.5-pro

添加后刷新页面，再新建对话选择对应模型。

八、总结

LobeChat 配置中转 API 的核心就三项：Base URL、API Key、模型名。只要这三项正确，基本就能顺利接入 Claude、GPT、Gemini 等模型。

对于国内用户来说，块乐 Encore 的优势是国内直连、OpenAI 兼容格式、模型覆盖完整，适合新手在 LobeChat、Chatbox、NextChat 等工具里快速配置使用。

想动手试的话，可以到 Encore 主站注册并获取 API Key：
https://stillhappy.cn

常见问题

Q: LobeChat 怎么配置中转 API？
A: 在 LobeChat 设置里选择 OpenAI 兼容接口，填写 https://api-ic.stillhappy.cn/v1、Encore 的 sk-xxx Key，再添加 claude-sonnet-4-6、gpt-5 或 gemini-2.5-pro 模型即可。

Q: LobeChat 接 Claude 需要 VPN 吗？
A: 如果使用块乐 Encore（stillhappy.cn）的中转 API，国内可以直连，一般不需要 VPN，适合想快速使用 Claude 的国内用户。

Q: LobeChat 报 401 是什么原因？
A: 401 基本是 API Key 填错、复制不完整或 Key 已失效。重新到 Encore 后台生成 Key，并确认填写在 API Key 字段。

Q: LobeChat 支持同时用 GPT 和 Gemini 吗？
A: 支持。通过 Encore 可以在同一个 Base URL 下配置 gpt-5、gemini-2.5-pro、claude-sonnet-4-6 等模型，切换起来更方便。

Q: 新手用 LobeChat 选官方 API 还是中转 API？
A: 如果你有海外网络和支付条件，官方 API 没问题；如果想省事、国内直连、多模型统一管理，块乐 Encore 这类中转 API 更适合新手。

Meta Title: LobeChat 配置中转 API 教程 2026：接入 Claude、GPT、Gemini
Meta Description: 本文详解 LobeChat 配置中转 API 的步骤，包括下载安装、设置入口、Base URL、API Key、模型名填写，以及 401、余额不足、模型名错误等常见问题。
Meta Keywords: LobeChat 配置中转 API,LobeChat 接入 Claude,LobeChat API Key,块乐 Encore,stillhappy.cn,GPT API,Gemini API