LobeHub - AI Agent 与模型工作台

优先使用内置 cnAPI

新版 LobeHub 已内置 cnAPI 服务商。cnAPI 基于 cnAPI，使用该入口可以获取 模型列表并按模型类型路由，无需把所有模型都当作普通 OpenAI 服务商处理。

LobeHub 是开源的 AI Agent 与模型工作台，支持管理多个模型服务商、Agent、知识库和工具。

• 官网：https://lobehub.com
• GitHub：https://github.com/lobehub/lobehub
• 版本发布：https://github.com/lobehub/lobehub/releases

使用前准备

1. 在 cnAPI 控制台创建 API Key。
2. 建议将 LobeHub 更新到当前稳定版。内置 cnAPI 服务商从 v1.123.0 开始提供， 后续版本补充了自定义 API 地址。
3. 准备要启用的准确模型 ID。

配置参数

API 地址不要带 /v1

LobeHub 的 cnAPI 路由器会按模型类型自动补充对应路径。请填写 https://cnapi.vip，不要填写 https://cnapi.vip/v1。

配置步骤

1. 打开 LobeHub，进入 设置。
2. 选择 AI 服务商，在服务商列表中打开 cnAPI。
3. 开启 启用 cnAPI。
4. 在 API 密钥 中粘贴自己的 cnAPI API Key。
5. 在 API 地址 中填写 https://cnapi.vip。
6. 找到 连通性检查，点击 检查。显示“检查通过”后继续。
7. 点击 获取模型列表，等待 LobeHub 从 cnAPI 读取模型。
8. 在 模型列表 中勾选希望在会话中显示的模型并保存。

下图以 LobeHub 官方服务商设置页为底图，仅将服务商、API 地址和首个模型替换为 cnAPI 示例值；API Key 未显示。

9. 返回会话页，选择该服务商下的模型开始对话。

Responses API 选项

cnAPI 服务商页面可能显示 使用 Responses API 规范。它用于 OpenAI 新一代请求格式， 并不代表所有经 cnAPI 提供的模型都支持该协议。

• 普通聊天首次配置时保持关闭。
• 只有 cnAPI 对应模型和渠道明确支持 Responses API 时再开启。
• Claude、Gemini 等模型经 cnAPI 路由时，不要仅根据模型名称强行开启。

验证是否成功

1. 连通性检查 显示“检查通过”。
2. 获取模型列表 后能看到当前账户可用模型。
3. 选择其中一个模型发送测试消息。
4. 在 cnAPI 控制台使用日志中确认出现对应请求。

常见问题

设置中找不到 cnAPI

当前版本过旧。请先更新 LobeHub；该服务商从 v1.123.0 开始加入，自定义 API 地址在 后续版本中完善。本文按稳定版 v2.2.13 的字段核验。

连通性检查失败

确认 API 地址为 https://cnapi.vip、API Key 完整有效。不要把 /v1/chat/completions 或其他完整端点填入 API 地址。

能检查通过，但会话里看不到模型

获取模型列表后还需要在 模型列表 中勾选模型。模型是否显示与账户权限和 cnAPI 当前配置有关。

某个模型开启 Responses 后报错

关闭该模型的 使用 Responses API 规范，保存后重新发起会话。基础兼容调用成功后， 再按模型能力决定是否使用 Responses。

官方依据

• LobeHub v2.2.13
• 内置 cnAPI 服务商定义
• cnAPI 设置页面源码
• cnAPI 路由实现
• LobeHub v1 更新记录

[

RAGFlow - 开源 RAG 与 Agent 平台

在 RAGFlow 中优先使用 cnAPI 模型供应商接入 cnAPI，并分别配置聊天模型与 Embedding 模型。

](/zh/docs/apps/ragflow)[

Cline - VS Code AI 编程助手

在 Cline 中配置 cnAPI 的地址、密钥和模型，完成首次对话与故障排查。

](/zh/docs/apps/cline)