开源可自托管
桌面端、网页端、Docker、Vercel 均可部署，数据完全可控
插件与多模态
内置联网搜索、代码解释器、图像理解、视频生成等插件
本地知识库
支持上传 PDF / Markdown 建立 RAG，对话引用私有资料
快速开始
1. 获取 API易 密钥
请参考 API密钥获取与管理教程 获取您的 API 密钥。2. 安装 LobeHub
LobeHub 提供三种使用方式：- 桌面版：Windows、macOS、Linux 官方客户端，可在
lobechat.com下载安装包 - 网页版（官方）：直接访问
lobechat.com注册登录即可使用，无需自部署 - 自托管：通过 Docker / Vercel / 本地源码部署，适合企业或隐私场景
3. 创建自定义服务商
+ 添加自定义服务商，按上图填写以下信息：
填写完成后点击右下角 新建 按钮保存。
配置要点
- 「代理地址」必须以
/v1结尾，否则请求会路由失败 - 「API Key」粘贴时请删除前后空格
- 「请求格式」选择
OpenAI即可访问 API易 全部 400+ 模型 - 一个密钥可同时启用多种模型，按用量计费，无需为单模型单独付费
4. 验证连通性
- 填写 API Key 与代理地址：再次确认或修改
- 开启高级选项（可选）：
- 「使用 Responses API 规范」：开启后可使用 OpenAI 新一代请求格式（仅 OpenAI 模型支持）
- 「使用客户端请求模式」：浏览器直接发起会话，可提升响应速度
- 连通性检查：在下拉框中选择一个模型，点击 检查 按钮测试连通性
- 获取模型列表：点击 获取模型列表 按钮，自动拉取 API易 提供的全部模型
5. 选择模型开始对话
在对话界面的模型下拉框中，选择您想使用的模型（如deepseek-v4-pro、claude-sonnet-4-5、gpt-5），即可开始对话。
查看当下热门模型推荐
查看最新的模型推荐、性能对比和场景化使用建议，涵盖文本创作、编程开发、快速响应、图像生成、视频生成等全场景。
为什么不在此列出具体模型？AI 模型更新迭代速度非常快，为了确保您获取最准确的模型推荐信息，我们统一在 模型推荐页面 维护最新的模型列表、性能数据和使用建议。
一站式接入 400+ 模型
LobeHub 内置了多种主流服务商的官方渠道，您可以根据使用场景选择最合适的接入方式：LobeHub 特色玩法
插件系统
LobeHub 提供丰富的插件市场（设置 → 插件），推荐开启：- Web 搜索：让模型实时联网获取最新信息
- 代码解释器：对话中运行 Python 代码、做数据可视化
- 图表生成：自动生成流程图、思维导图
- 图像生成：通过
gpt-image-1、flux-kontext-pro等模型生成图片
本地知识库（RAG）
LobeHub 支持上传文件建立本地向量库：- 进入「知识库」页面，新建知识库
- 上传 PDF、Markdown、Word、Excel、TXT 等文件
- 系统自动切片、向量化
- 对话时勾选知识库，模型将基于您的私有资料回答
多模态对话
支持上传图片进行视觉理解、识图、OCR：- 视觉模型推荐：
gpt-4o、claude-sonnet-4-5、gemini-3-pro-image-preview - 直接在对话框拖入图片，模型会自动识别
助手市场（Agent Market）
LobeHub 内置丰富的预设助手（翻译、写作、编程、面试等），您也可以：- 在「助手市场」一键启用社区分享的助手
- 自建助手：自定义人设、Prompt、开场白、知识库、插件
对话管理与导出
- 多分支对话、消息编辑与重新生成
- 对话导出：Markdown、PNG、JSON
- 全局搜索历史消息
高级配置
自定义请求参数
进入服务商详情页可调节通用参数：网络代理与自托管
如需使用代理或自托管 LobeHub：- 桌面版：设置 → 网络 → 配置 HTTP/HTTPS 代理
- 自托管（Docker）：通过环境变量注入 API易 配置：
- 客户端请求模式：开启后浏览器直连 API（需保证浏览器能访问 API易）
快捷键
移动端
LobeHub 桌面端支持 Windows / macOS / Linux，移动端可通过浏览器访问lobechat.com 网页版（响应式适配），无需单独安装 App。
故障排除
连接失败 / 连通性检查不通过
模型列表为空
- 点击 获取模型列表 按钮手动拉取
- 等待 1-2 秒后刷新页面
- 确认 API Key 在 API易 控制台状态正常
响应慢或流式断流
- 切换到更快模型（如
gpt-5-mini、claude-haiku-4-5、deepseek-v4-flash） - 关闭不必要的插件
- 检查网络延迟
- 减少上下文长度（关闭过长的旧对话）
知识库检索不准确
- 调小切片大小，让检索粒度更细
- 在 API易 中切换更优的 Embedding 模型
- 增加相关文档数量，提高召回率
最佳实践
模型选择策略
不同任务用不同模型，按复杂度梯度选择：- 日常聊天 / 简单问答：
gpt-5-mini、claude-haiku-4-5、deepseek-v4-flash - 复杂推理 / 长文档分析：
gpt-5、claude-opus-4-5、deepseek-v4-pro - 代码开发：
claude-sonnet-4-5、gpt-5、deepseek-v4-pro - 图像理解：
gpt-4o、claude-sonnet-4-5、gemini-3-pro-image-preview - 图像生成：
gpt-image-1、flux-kontext-pro
上下文管理
- 定期清理无用的旧对话
- 复杂任务拆分成多个短对话
- 善用「分叉对话」功能探索不同回答
安全与隐私
- 不要在公共场合分享 API Key
- 定期更换密钥（API易 控制台可一键重置）
- 敏感对话建议自托管 LobeHub，数据完全本地存储
自托管建议
- 生产环境使用 Docker + PostgreSQL，不要用内置数据库
- 反向代理建议套 Cloudflare
- 通过环境变量集中管理密钥，便于多实例部署
与其他客户端的对比
需要更多帮助？请访问
lobechat.com 官方文档或 API易官网 获取更多支持。