跳转到主要内容
Cherry Studio 是一个开源跨平台 AI 桌面客户端,支持同时配置多家 LLM 服务商、本地知识库、Agent 等功能。RuAPI 通过 OpenAI 兼容 协议接入。

前置条件

1

RuAPI 账号 + API key

控制台 → 令牌管理 创建一把 sk-...。
最快的办法是用控制台里的现成配置。 打开 控制台 → 令牌管理,点「接入 Claude Code、Cline 等工具」,选 Cherry Studio。「一键添加 RuAPI 到 Cherry Studio」按钮会自动添加 RuAPI 服务商(Cherry Studio 第一次启动的话,先在欢迎页点右上角「稍后设置」),窗口里也有填好你密钥的字段,可以手动填。按下面的步骤装好程序,再照窗口里的说明做完(服务商、模型 deepseek-flash、检测),「添加 RuAPI 服务商」一节就只剩最后一步:选默认模型。
RuAPI 令牌管理页:地址 https://www.ruapi.ai 和「接入 Claude Code、Cline 等工具」按钮

控制台 → 令牌管理:「接入 Claude Code、Cline 等工具」按钮

RuAPI 控制台「接入工具」窗口里 Cherry Studio 的现成配置

「接入工具」窗口,选中 Cherry Studio:地址和密钥都已填好(截图里的密钥已打码)

安装 Cherry Studio

到 cherry-ai.com 或 GitHub Releases 下载:
下载 Cherry-Studio-Setup-x.y.z.exe → 双击安装。

添加 RuAPI 服务商

下面的步骤和截图基于 Cherry Studio 2.1.6(2026 年 10 月)。其他版本的按钮名称可能略有不同。
1

打开添加服务商

第一次启动 Cherry Studio 时,点「配置其他服务商」,再点列表底部的「添加服务商」。如果 Cherry Studio 已经用过:「设置」→「模型服务」→「添加服务商」。
2

填写表单

地址下面会显示请求路径 https://www.ruapi.ai/v1/chat/completions,说明地址填对了。Anthropic 一栏可以留空。点「添加」。
Cherry Studio 添加服务商表单:RuAPI,地址 https://www.ruapi.ai

新服务商表单:名称、密钥和 OpenAI 地址

3

添加模型 deepseek-flash

Cherry Studio 会弹出 RuAPI 的模型列表,先点「跳过」。然后点「同步模型」右边的「+」,「模型 ID」填 deepseek-flash(「模型名称」和「分组名称」会自动填成一样的),点「添加模型」。
还没充值的话,体验额度 0.05 美元(新用户注册时送)只能用 deepseek-flash、claude-haiku-5-5 和 gpt-6-luna。充值 5 美元以上后,其他模型点「同步模型」从列表里勾选添加,价格见价格页。
Cherry Studio 添加模型窗口:模型 ID、模型名称、分组名称都是 deepseek-flash

添加模型:模型 ID 填 deepseek-flash

4

检测并启用

点 API 密钥右边的「检测」,在弹出的窗口里点「开始」。检测通过后,右上角的开关会变成绿色,服务商就启用了。
Cherry Studio 检测窗口:选中 deepseek-flash,点开始

检测 deepseek-flash

服务商页面上能看到密钥、地址和 deepseek-flash 模型。
Cherry Studio 的 RuAPI 服务商页面:密钥、地址和 deepseek-flash 模型

RuAPI 服务商已设置并启用

5

选择默认模型

第一次启动时,点右下角的「下一步」,进入「选择默认模型」。点第一个下拉框,选 RuAPI 下的 deepseek-flash,另外两项会自动填上一样的模型,再点「开始使用」。
Cherry Studio 选择默认模型:默认助手模型、快速模型、翻译模型都是 RuAPI 的 deepseek-flash

三个默认模型都是 deepseek-flash

如果接着弹出「启用 API Gateway?」,点「取消」就行:这是 Cherry Studio 智能体功能用的,普通对话用不到。

第一次验证

打开左侧的「对话」(对话气泡图标),点顶部的模型名,选 RuAPI 下的模型,发送:
正常拿到回复 + RuAPI 控制台 → 使用日志 有对应调用 = 成功。

设置默认模型

设置 → 默认模型:
  • 默认助手模型:日常聊天用的,建议用 GPT 或 Claude Sonnet 系列。
  • 快速模型:给对话起标题、提炼搜索关键词这类简单任务用的,用 Claude Haiku 这种便宜的模型就够。
  • 翻译模型:建议用便宜的小模型(如 GPT mini 或 Claude Haiku)。
还在用体验额度的话,这几项都选 RuAPI 下的 deepseek-flash:Cherry Studio 默认用的是它自带的模型,不走 RuAPI。

常见问题

  • API 密钥填的应该是 RuAPI 令牌(sk-...),不是 OpenAI 官方 key。
  • 复制时小心末尾空格。
  • 控制台 → 令牌管理 看 key 状态。
  • 模型 ID 拼写。手动添加时,「模型 ID」必须和 RuAPI 上的完全一致(比如 deepseek-flash),前后不要有空格。其他模型建议用「同步模型」从列表里勾选。
  • API 地址末尾 不要 加 /chat/completions,只填到 https://www.ruapi.ai 即可。
Cherry Studio 默认开启流式(SSE),RuAPI 默认也支持。如果遇到卡顿:
  • 检查网络稳定性。
  • 设置里关掉「流式输出」试试,对比一下。
Cherry Studio 的 MCP 功能依赖模型支持 function calling。GPT、Claude 系列都能可靠地做工具调用(见函数调用),再按 Cherry Studio 内置的 MCP 设置走即可。
确认选的模型支持视觉。RuAPI 上能看图的有 GPT、Claude、Gemini 和 deepseek-flash;GLM 模型只读文字,见图片理解。
Cherry Studio 支持任意多个服务商并存。重复上面的添加流程即可。聊天时右上角切换模型自动切服务商。

进阶

  • 知识库:Cherry Studio 内置 RAG,需要一个嵌入(embedding)模型。RuAPI 提供 text-embedding-3-small 和 text-embedding-3-large:在 RuAPI 提供商里像普通模型一样用 「+」 按模型 ID 添加(如果 Cherry Studio 没自动识别类型,把它标成嵌入模型),建知识库时选它。嵌入模型充值后开放。如果文档不能上传到云端,就接本地的嵌入模型(比如通过 Ollama),对话继续用 RuAPI。
  • Agent / 智能体:Cherry Studio 的 Agent 功能完全在客户端跑,调用模型走配好的服务商。建议给 Agent 配 Claude Sonnet 或 GPT 系列。
  • 多账户:如果一把 key 不够分,可以在 RuAPI 控制台多建几把 key 各自限额,给不同的 Cherry Studio profile 用。