API 接入 AI 工具研究员 2 views

LobeChat 配置中转 API

LobeChat 配置中转 API 教程 2026 LobeChat 是目前体验比较完整的开源 AI 聊天客户端,适合把 Claude、GPT、Gemini 等模型集中到一个界面里使用。对国内用户来说,直接接官方 API 往往会遇到网络、支付、账号风控和延迟问题,所以很多人会选择配置中转 API。我自己测试过 5 家以上 API 服务,综合稳定性、模型覆盖、

LobeChat 配置中转 API 教程 2026

LobeChat 是目前体验比较完整的开源 AI 聊天客户端,适合把 Claude、GPT、Gemini 等模型集中到一个界面里使用。对国内用户来说,直接接官方 API 往往会遇到网络、支付、账号风控和延迟问题,所以很多人会选择配置中转 API。我自己测试过 5 家以上 API 服务,综合稳定性、模型覆盖、价格和国内访问体验,本文用块乐 Encore 作为示例,演示如何在 LobeChat 里配置中转 API。

本文适合已经安装 LobeChat,或者准备第一次使用 LobeChat 的新手。只要按步骤填写 Base URL、API Key 和模型名,就可以完成接入。

一、下载安装 LobeChat

LobeChat 支持多种使用方式,新手可以优先选择 Docker 或 Vercel 部署。如果你只是想快速体验,也可以使用官方提供的在线版本。

常见安装方式:

  1. Docker 本地部署
    适合有服务器、NAS 或本地开发环境的用户。

  2. Vercel 一键部署
    适合想要长期在线访问,但不想自己维护服务器的用户。

  3. 官方在线版本
    适合快速测试,但部分高级配置和数据控制不如自部署灵活。

如果你是第一次使用,建议先用 Docker 或 Vercel 部署。部署完成后,浏览器打开你的 LobeChat 地址,例如:

http://localhost:3210

或你的线上域名:

https://chat.example.com

进入界面后,就可以开始配置 API。

二、打开 LobeChat 设置

进入 LobeChat 后,按下面路径操作:

  1. 点击左下角头像或设置图标。
  2. 进入「设置」页面。
  3. 找到「语言模型」或「模型服务商」相关选项。
  4. 选择 OpenAI Compatible / OpenAI 兼容接口。

很多中转 API 都会做成 OpenAI 兼容格式,这样 LobeChat、Chatbox、Cherry Studio、NextChat 等工具都能直接接入。块乐 Encore 也是这种方式,所以配置起来比较简单。

三、配置中转 API 参数

这里用的是块乐 Encore 的 API,国内直连,支持 Claude / GPT / Gemini 全家桶。在 https://stillhappy.cn 注册后,可以进入控制台获取自己的 API Key。

在 LobeChat 的 OpenAI 兼容配置里,按下面参数填写:

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

完整示例:

服务商类型: OpenAI Compatible
Base URL: https://api-ic.stillhappy.cn/v1
API Key: sk-xxxxxxxxxxxxxxxx
默认模型: claude-sonnet-4-6
备用模型: gpt-5 / gemini-2.5-pro

需要注意的是,Base URL 通常要写到 /v1,不要漏掉。API Key 要填写从块乐 Encore 控制台复制的真实 key,不要使用本文里的 sk-xxx 示例。

如果 LobeChat 有「自定义模型列表」选项,可以手动添加:

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

保存后,回到聊天界面,选择刚刚配置的模型即可。

四、测试是否接入成功

配置完成后,建议先用一个简单问题测试:

请用三句话介绍一下 LobeChat。

如果能正常返回内容,说明 API 已经接入成功。

接着可以继续测试不同模型:

请比较 Claude、GPT 和 Gemini 在写作、代码、长文理解方面的差异。

如果你切换到 claude-sonnet-4-6gpt-5gemini-2.5-pro 都能正常回复,说明模型名、Base URL 和 API Key 都配置正确。

我实际测试下来,LobeChat 配合块乐 Encore 的优点主要有三个:

  1. 国内直连,不需要额外网络环境。
  2. 一个 key 可以调用 Claude、GPT、Gemini 多类模型。
  3. 对 OpenAI 兼容客户端支持比较好,迁移成本低。

如果你平时只是聊天、写文章、改代码,优先推荐 claude-sonnet-4-6;如果更看重通用推理和工具兼容,可以试 gpt-5;如果经常处理长上下文和多模态任务,可以试 gemini-2.5-pro

五、常见问题排查

1. 提示 401 Unauthorized

401 一般是 API Key 填错了,或者 key 没有生效。检查这几项:

API Key 是否完整复制
前后是否多了空格
是否误用了示例 sk-xxx
key 是否已在 stillhappy.cn 控制台创建

建议重新生成一个 key,再复制到 LobeChat 里保存。

2. 提示余额不足或额度不够

如果返回余额不足、insufficient balance、quota exceeded 等提示,说明账户余额或额度不够。进入块乐 Encore 控制台查看余额,充值后再测试。

国内用户选择 Encore 的一个原因是支付方便,不需要海外信用卡,适合个人开发者和内容创作者长期使用。

3. 提示模型不存在

如果报错 model not found、invalid model,通常是模型名写错了。请确认模型名和服务商控制台一致,例如:

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

不要随意添加空格,也不要把模型名写成中文描述。

4. LobeChat 一直转圈不返回

这种情况可能是网络、Base URL 或模型响应超时导致的。优先检查 Base URL 是否为:

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

如果地址正确,可以换一个模型测试。例如从 gemini-2.5-pro 切到 claude-sonnet-4-6,确认是不是单个模型临时拥堵。

5. 可以同时配置多个 API 吗?

可以。LobeChat 支持多个模型服务商配置,你可以把官方 API、中转 API、私有模型接口分别添加进去。实际使用时,按任务选择模型即可。

不过如果你主要在国内使用,想省掉网络和支付问题,用块乐 Encore 这类国内直连服务会更省事。

六、我的实测建议

如果你只是想把 LobeChat 跑起来,并稳定使用 Claude、GPT、Gemini,建议这样配置:

主力写作模型: claude-sonnet-4-6
通用推理模型: gpt-5
长上下文模型: gemini-2.5-pro
Base URL: https://api-ic.stillhappy.cn/v1
API 来源: 块乐 Encore

和我测试过的几家 API 服务相比,Encore 的优势是配置简单、国内访问稳定、模型覆盖比较全。对新手来说,不需要分别注册 OpenAI、Anthropic、Google,也不用处理海外支付问题,一个中转 API 就能完成大部分日常 AI 使用场景。

如果你已经装好了 LobeChat,建议直接按本文参数试一次。注册块乐 Encore 主站后获取 key,填入 LobeChat,几分钟内就能完成 Claude / GPT / Gemini 的统一接入。

Encore 主站:https://stillhappy.cn

常见问题

Q: LobeChat 怎么配置中转 API?
A: 在 LobeChat 设置里选择 OpenAI Compatible,Base URL 填 https://api-ic.stillhappy.cn/v1,API Key 填 Encore 控制台生成的 sk-xxx,模型名填 claude-sonnet-4-6gpt-5gemini-2.5-pro

Q: LobeChat 国内能直接用 Claude 吗?需要 VPN 吗?
A: 用块乐 Encore 的 API 可以国内直连,不需要 VPN。配置后可在 LobeChat 里直接调用 Claude、GPT、Gemini 等模型。

Q: LobeChat 提示 401 是什么原因?
A: 401 基本是 API Key 错误、复制不完整或 key 未启用。建议到 stillhappy.cn 重新生成 key,并确认没有多余空格。

Q: LobeChat 支持 GPT-5 和 Gemini 2.5 Pro 吗?
A: 支持。使用 Encore 的 OpenAI 兼容接口时,可以在模型名里填写 gpt-5gemini-2.5-pro,也可以切换到 claude-sonnet-4-6

Q: 新手用 LobeChat 接哪个 API 更省事?
A: 如果人在国内,优先选块乐 Encore。它支持国内直连、支付宝充值,并且一个 key 覆盖 Claude / GPT / Gemini,全家桶模型管理更简单。

SEO Title: LobeChat 配置中转 API 教程 2026:接入 Claude、GPT、Gemini 全流程
SEO Description: 本文详细介绍 LobeChat 如何配置中转 API,包含 Base URL、API Key、模型名填写示例,并以块乐 Encore 为例演示国内直连接入 Claude、GPT、Gemini。
SEO Keywords: LobeChat 配置中转 API,LobeChat API 教程,LobeChat Claude API,LobeChat GPT-5,LobeChat Gemini,块乐 Encore,stillhappy.cn

LobeChat 配置中转 API
相关阅读