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

「接入工具」窗口,选中 Cherry Studio:地址和密钥都已填好(截图里的密钥已打码)
安装 Cherry Studio
到 cherry-ai.com 或 GitHub Releases 下载:- Windows
- macOS
- Linux
下载
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 一栏可以留空。点「添加」。
新服务商表单:名称、密钥和 OpenAI 地址
3
添加模型 deepseek-flash
Cherry Studio 会弹出 RuAPI 的模型列表,先点「跳过」。然后点「同步模型」右边的「+」,「模型 ID」填 
deepseek-flash(「模型名称」和「分组名称」会自动填成一样的),点「添加模型」。还没充值的话,体验额度 0.05 美元(新用户注册时送)只能用
deepseek-flash、claude-haiku-5-5 和 gpt-6-luna。充值 5 美元以上后,其他模型点「同步模型」从列表里勾选添加,价格见价格页。
添加模型:模型 ID 填 deepseek-flash
4
检测并启用
点 API 密钥右边的「检测」,在弹出的窗口里点「开始」。检测通过后,右上角的开关会变成绿色,服务商就启用了。
服务商页面上能看到密钥、地址和 

检测 deepseek-flash
deepseek-flash 模型。
RuAPI 服务商已设置并启用
5
选择默认模型
第一次启动时,点右下角的「下一步」,进入「选择默认模型」。点第一个下拉框,选 RuAPI 下的 
如果接着弹出「启用 API Gateway?」,点「取消」就行:这是 Cherry Studio 智能体功能用的,普通对话用不到。
deepseek-flash,另外两项会自动填上一样的模型,再点「开始使用」。
三个默认模型都是 deepseek-flash
第一次验证
打开左侧的「对话」(对话气泡图标),点顶部的模型名,选 RuAPI 下的模型,发送:设置默认模型
设置 → 默认模型:- 默认助手模型:日常聊天用的,建议用 GPT 或 Claude Sonnet 系列。
- 快速模型:给对话起标题、提炼搜索关键词这类简单任务用的,用 Claude Haiku 这种便宜的模型就够。
- 翻译模型:建议用便宜的小模型(如 GPT mini 或 Claude Haiku)。
deepseek-flash:Cherry Studio 默认用的是它自带的模型,不走 RuAPI。
常见问题
提示 401 / 鉴权失败
提示 401 / 鉴权失败
- API 密钥填的应该是 RuAPI 令牌(
sk-...),不是 OpenAI 官方 key。 - 复制时小心末尾空格。
- 控制台 → 令牌管理 看 key 状态。
找不到模型(503)或 404
找不到模型(503)或 404
- 模型 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 模型只读文字,见图片理解。想同时挂 RuAPI + 其他服务商
想同时挂 RuAPI + 其他服务商
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 用。