OpenModelOpenModel
集成指南

LobeHub

配置 LobeHub 使用 OpenModel 作为 API 供应商

概述

LobeHub 是一款广受欢迎的开源 AI 聊天平台和个人 AI 助手。它支持多种 AI 供应商，提供简洁现代的界面，并可作为桌面应用在 Windows、macOS 和 Linux 上运行。通过在 LobeHub 中将 OpenModel 配置为自定义供应商，你可以在统一的聊天界面中访问 OpenModel 提供的所有模型，包括 GPT、Claude、Gemini、DeepSeek 等。

本指南将带你完成 LobeHub 的安装、连接 OpenModel、添加模型以及验证配置是否正常工作的全部步骤。

前置条件

请确保以下条件已满足：

  • OpenModel API Key -- 如果你还没有，请参阅 认证 指南，在 OpenModel 控制台 中创建 API Key。你的密钥以 om- 开头。
  • 一台桌面电脑，运行 Windows、macOS 或 Linux 操作系统。

安装 LobeHub

  1. 访问 LobeHub 官方网站 lobehub.com。
  2. 下载适用于你操作系统的安装包（Windows、macOS 或 Linux）。
  3. 运行安装程序，按照屏幕上的指引完成安装。

从官方网站下载 LobeHub

完成初始化设置

  1. 安装完成后启动 LobeHub 应用。
  2. 按照首次启动时出现的初始化向导进行设置。通常包括选择语言、主题和其他基本偏好设置。
  3. 完成设置，进入主聊天界面。

LobeHub 初始化设置

打开设置

  1. 在主界面中，找到窗口左上角的头像（个人图标）。
  2. 点击头像，打开用户菜单。
  3. 点击设置，打开设置面板。

点击头像，然后点击设置

添加新供应商

  1. 在设置面板中，从左侧边栏选择供应商选项卡。
  2. 点击添加按钮，添加新的 AI 供应商。

选择供应商选项卡并点击添加

配置 OpenModel 供应商

这是最关键的一步。你需要正确配置连接信息，以便 LobeHub 能够与 OpenModel API 通信。

请填写以下字段：

字段值说明
供应商名称OpenModel你可以使用任何你喜欢的名称，但建议使用 OpenModel 以便识别。
请求格式OpenAI 或 Anthropic请根据你要使用的模型选择正确的格式，详见下方说明。
API 代理地址https://api.openmodel.ai这是 OpenModel 的 API 基础地址，请按原样输入。
API Key你的 OpenModel API Key粘贴你在 OpenModel 控制台中创建的 API Key（以 om- 开头）。

如何选择请求格式

请求格式决定了 LobeHub 使用哪种 API 协议与 OpenModel 通信。你必须根据要使用的模型选择正确的格式：

  • OpenAI -- 适用于使用 Responses 协议的模型，例如：

    • gpt-5.4、gpt-5.4-mini、o3、o4-mini 等 OpenAI 模型
    • 通过 OpenAI SDK 使用的 DashScope 模型（如 qwen3-max）

  • Anthropic -- 适用于使用 Messages 协议的模型，例如：

    • claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4-5-20251001 等 Anthropic 模型
    • deepseek-v4-flash、deepseek-v4-pro（DeepSeek）
    • qwen3-max、qwen3.5-72b（通过 Messages 协议的 DashScope）
    • kimi-k2.6、minimax-m3 等其他 Messages 协议供应商

提示

如果你想同时使用两种协议的模型，可以在 LobeHub 中创建两个独立的供应商 -- 一个使用 OpenAI 格式，一个使用 Anthropic 格式。这样你就可以自由切换。完整的模型和协议列表请参见 可用模型。

填写完所有字段后，点击创建保存供应商配置。

配置供应商详情

添加模型

创建供应商后，你需要添加要使用的具体模型。

  1. 在供应商设置中，选择你刚刚创建的 OpenModel 供应商。
  2. 向下滚动到模型列表部分。
  3. 点击添加模型按钮来添加新模型。

选择供应商并点击添加模型

配置模型详情

在模型配置对话框中，填写模型详情：

字段说明示例
模型 IDAPI 使用的准确模型标识符，必须与 OpenModel 上的模型名称完全一致。claude-opus-4-6
显示名称在 LobeHub 界面中显示的友好名称。Claude Opus 4
上下文窗口模型能够处理的最大 token 数（输入 + 输出）。200000

提示

你可以在 模型定价 页面查看准确的模型 ID、上下文窗口大小和其他规格信息。

填写完模型详情后，点击确定保存。

配置模型详情

对于你想要添加的每个模型，重复第六步和第七步。你可以根据需要添加任意数量的模型。

选择模型

  1. 关闭设置面板，返回主聊天界面。
  2. 在聊天区域找到模型选择器（通常在顶部或输入区域附近）。
  3. 点击模型选择器，打开模型列表。

在主界面切换模型

找到你配置的模型

在模型选择下拉菜单中，找到并选择你通过 OpenModel 供应商配置的模型。

找到并选择你配置的模型

验证配置

发送一条测试消息，验证配置是否正常工作：

  1. 在聊天输入框中输入一条简单的消息，例如"你好，你是谁？"。
  2. 按下回车键发送消息。
  3. 如果你收到了模型的回复，说明配置成功。

成功的聊天响应

常见问题排查

"请求失败"或无响应

  • 检查 API Key： 确保你正确复制了 OpenModel API Key，它应该以 om- 开头。你可以通过 cURL 测试它是否有效 -- 参见 快速开始 指南。
  • 检查 API 代理地址： 确保地址为 https://api.openmodel.ai，末尾不要有多余的斜杠或路径。
  • 检查账户余额： 登录 OpenModel 控制台，确认你的账户有足够的余额。

响应格式错误或报错

  • 确认请求格式： 如果你使用的是 Claude 模型但选择了 OpenAI 请求格式（或反之），LobeHub 会以错误的协议发送请求，API 将返回错误。请仔细检查请求格式是否与模型的协议匹配。详情请参见 可用模型。

模型未出现在选择器中

  • 检查模型是否已添加： 返回设置 > 供应商 > OpenModel，确认模型出现在模型列表中。
  • 检查模型 ID： 模型 ID 必须与 OpenModel 使用的标识符完全一致（例如 claude-opus-4-6，而不是 claude opus 4）。请在 模型定价 页面查看正确的模型 ID。

响应缓慢或超时

  • 检查网络连接： 确保你的网络连接稳定。
  • 尝试其他模型： 某些模型可能延迟较高。尝试使用较小的模型（如 claude-haiku-4-5-20251001 或 gpt-5.4-mini）来测试连接。
  • 检查速率限制： 你可能触及了速率限制。详情请参见 速率限制 指南。

下一步

  • 可用模型 -- 浏览所有支持的供应商和模型，为 LobeHub 添加更多模型
  • 模型定价 -- 查看模型规格、上下文窗口和定价信息
  • 流式响应 -- 了解流式传输支持（LobeHub 默认使用流式传输来实现实时响应）
  • 认证 -- 管理你的 API Key，设置配额和过期时间

Cherry Studio

配置 Cherry Studio 使用 OpenModel 作为 API 供应商

Claude Code

通过 CC-Switch 配置 Claude Code 使用 OpenModel 作为 API 供应商

本页目录

概述前置条件安装 LobeHub完成初始化设置打开设置添加新供应商配置 OpenModel 供应商如何选择请求格式添加模型配置模型详情选择模型找到你配置的模型验证配置常见问题排查"请求失败"或无响应响应格式错误或报错模型未出现在选择器中响应缓慢或超时下一步