Cherry Studio 接入

一键导入服务商Key 仅在当前浏览器中编码，不会上传到文档站。

API Key

导入完成后，仍需在 Cherry Studio 中添加控制台提供的模型 ID。

在 Cherry Studio 新增一个自定义服务商，填入地址、Key 和模型 ID 即可。首次只测试纯文本。

工具官网：Cherry Studio ↗

服务商类型OpenAI Compatible

Base URLhttps://api.reniuniu.win/v1

模型从控制台复制

接入方式配置后测试

第一步：准备 Key 和模型

1. 在牛API控制台创建 Cherry Studio 专用 Key；
2. 确认 Key 所属分组能够调用目标模型；
3. 复制模型 ID，不要复制展示名称。

第二步：新增服务商

进入 设置 → 模型服务 → 添加服务商，选择 自定义 / OpenAI Compatible。

字段	内容
名称	牛API
API Key	Cherry Studio 专用 Key
Base URL	https://api.reniuniu.win/v1
模型 ID	控制台中的真实模型 ID

Cherry Studio脱敏配置示意图

设置模型服务模型连接测试

模型服务连接参数

服务商类型OpenAI Compatible协议Chat CompletionsBase URLhttps://api.reniuniu.win/v1API Keyniu_••••••••••••_AB12模型 IDYOUR_MODEL_ID

示意图使用虚构 Key 和模型 ID，不对应特定版本界面；以客户端当前版本为准。

API Key 只粘贴 Key 本身，不要手动添加 Bearer 。如果界面明确写着“会自动拼接 /v1”，Base URL 才改填 https://api.reniuniu.win。

第三步：添加模型并保存

在服务商的模型列表中点击添加，把控制台模型 ID 原样粘贴。保存后完全退出 Cherry Studio 再打开，避免旧配置残留。

第四步：发送最小测试

新建对话，选择刚添加的模型，发送：

请只回复：牛API连接正常

收到回复后到控制台核对模型和用量。基础调用通过后，再逐项测试流式、视觉和工具能力。

常见问题

现象	处理
401	检查 Key 完整性、首尾空格和分组
404	检查 /v1 是否重复，以及模型 ID
模型不存在	从控制台重新复制 ID，注意大小写
429	关闭并行请求，以并发 1 重试
502	用短请求复现，记录时间和请求 ID

Key 安全

不要在截图、导出配置或同步服务中暴露完整 Key。泄露后立即撤销并重建。