跳转到内容
NoviaHub 文档

桌面应用

Cherry Studio

在 Cherry Studio 里添加 NoviaHub，用桌面客户端和 NoviaHub 上的模型聊天。

Cherry Studio 是一款桌面 AI 客户端，支持 Windows、macOS 和 Linux。它内置了一个叫「New API」的服务商，NoviaHub 与它兼容：只要填 NoviaHub 的地址和 API 密钥，同一个服务商就能按需使用 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 四种协议。

本页按 Cherry Studio v2（2026-09-24 发布的 v2.1.3）编写。界面文字以软件自带的中文为准。

前提条件

Section titled “前提条件”
  • 已经有一把 NoviaHub API 密钥。还没有的话，参见API 密钥。
  • 账户里有余额。调用按用量从余额扣费。

安装

Section titled “安装”

从 Cherry Studio 官方下载页 cherryai.com.cn/download/v2 下载对应系统的安装包：

系统 可选的安装包（v2.1.3）
Windows（x64、arm64） 安装版 .exe，或便携版 .exe
macOS（Apple 芯片、Intel） .dmg
Linux（x64、arm64） AppImage、.deb、.rpm

配置 NoviaHub

Section titled “配置 NoviaHub”

两种方式任选其一。一键导入省去手动填写地址和密钥，但两种方式最后都要添加模型并打开启用开关。

  1. 确认电脑上已经安装了 Cherry Studio。

  2. 登录 NoviaHub，打开「API 密钥」页面，找到要用的那把密钥，点这一行最右边的「⋯」，再选「聊天」→「Cherry Studio」。

  3. 浏览器会请求打开 Cherry Studio，选择允许。NoviaHub 会通过一个 cherrystudio:// 链接，把 NoviaHub 的地址 https://noviahub.com 和这把密钥交给 Cherry Studio 内置的 New API 服务商。

  4. Cherry Studio 会弹出「为 New API 添加 API 密钥」的确认框，列出服务商名称、服务商 ID（new-api）和基础 URL（https://noviahub.com）。核对无误后点「添加」。

    • 如果提示「New API 已有相同的 API 密钥，不会重复添加」，说明这把密钥之前已经导入过。
    • 如果提示「添加服务商 API 密钥失败，数据格式错误」，请改用方式二手动配置。

  5. 导入只写入地址和密钥，不会替你添加模型，也不会打开服务商的启用开关。接着按方式二的第 4～6 步添加模型、检测并启用。

验证

Section titled “验证”
  1. 在「模型服务」里点「检测」，选择一个模型，确认检测通过。
  2. 新建一个对话，在模型选择器里选中 New API 下的模型，发一句话，能收到回复就说明配置成功。
  3. 到 NoviaHub 的使用日志里，能看到这次调用的记录和费用。

切换模型

Section titled “切换模型”

在聊天界面的模型选择器里切换即可。能选的模型取决于你在第 4 步加进列表的模型。

NoviaHub 上可用的模型 ID 见模型&价格，例如 deepseek-v4-flash、claude-sonnet-5、gemini-3-flash（2026-09-28 线上存在）。模型 ID 要逐字一致。

注意事项

Section titled “注意事项”
  • 如果「检测」失败，检查其他协议的地址栏里有没有残留的旧地址（比如测试版留下的 localhost:3000），清空后再检测。
  • 「API 密钥」一栏可以填多把密钥，用英文逗号分隔，Cherry Studio 会轮流使用。
  • 一键导入时，导入数据里没有指定协议类型，Cherry Studio 会把这个服务商的默认聊天协议设为 OpenAI Chat。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28：