Cherry Studio API 接入指南
在 Cherry Studio 中添加 UniRoute 的 OpenAI 端点、API Key 与聊天模型，并为 Cherry Agent 配置 Anthropic 端点。
Cherry Studio 接入 · 按量 API
在「模型服务」中添加 UniRoute，再选择聊天模型。填写 OpenAI 聊天端点，并为每个模型选择对应的端点类型。
适合：使用桌面客户端进行文字对话、写作和代码问答的用户。
快速配置
登录后可一键创建 Key 并自动填入 登录
按字段复制并粘贴到客户端设置中。
提供商名称
UniRouteOpenAI
https://api.uniroute.app/v1API Key
YOUR_UNIROUTE_API_KEY模型 ID
deepseek-v4-flash端点类型
OpenAI配置步骤
1. 添加服务商
打开 设置 → 模型服务 → 添加服务商，在 提供商名称 中填入 UniRoute。
2. 填写端点与密钥
粘贴 API Key，在 端点设置 → OpenAI 中填入 https://api.uniroute.app/v1，点击 添加。聊天请求地址为 /v1/chat/completions。
3. 添加模型
进入 UniRoute 服务商页面，点击 同步模型 旁的 +。将 模型 ID 填为 deepseek-v4-flash，模型名称 填为 DeepSeek V4 Flash，分组名称 填为 UniRoute，端点类型 选为 OpenAI，保存。
也可以点击 同步模型，将返回的模型加入服务商列表。
4. 启用并选择 UniRoute
打开服务商启用开关，回到对话窗口，选择 UniRoute 下的模型。
先启用服务商并添加模型，聊天窗口才能选择。
这几个变量分别做什么
| 字段 | 用途 |
|---|---|
| OpenAI | Chat Completions 基础地址；客户端保留已有 /v1，再追加 /chat/completions。 |
| API Key | 用于 UniRoute 请求认证。 |
| 模型 ID | 实际发送给 API 的精确标识。 |
| 模型名称 / 分组名称 | 用于整理客户端模型列表的名称。 |
| 端点类型 | 决定该模型使用的协议。 |
选择模型
使用 Cherry Agent
编辑 UniRoute 服务商，在 端点设置 → Anthropic 中填入：
https://api.uniroute.app添加 claude-sonnet-5-5，将 端点类型 设为 Anthropic，再为 Cherry Agent 选择该模型。Cherry Agent 使用 Anthropic Messages，单独配置这个端点。
怎么确认已经切过来了
发送一句测试：请只回复：你好
打开 用量日志，查看模型、请求状态与扣费。测试会产生实际 API 费用。
在服务商页面点击 检测，再使用 UniRoute 模型新建聊天，查看回复并到用量日志核对。
切回原配置 / 恢复备份
在对话中选回原服务商的模型。关闭 UniRoute 服务商可隐藏其模型，也可以在模型服务中只删除该服务商。
还没安装？
从 Cherry Studio 官方下载页 安装客户端，再打开 设置 → 模型服务。
常见问题
OpenAI 要填写完整聊天接口吗？
填写 https://api.uniroute.app/v1，客户端会追加 /chat/completions。
一个服务商可以配置两种协议吗？
可以。分别填写 OpenAI 和 Anthropic 端点，再为每个模型选择相应的端点类型。
可以手动添加模型吗？
可以。点击 + 填入精确模型 ID，也可以从同步模型结果中选择并添加。
常见错误
聊天窗口找不到模型
服务商未启用，或模型尚未加入列表。
启用 UniRoute，并将模型加入其模型列表。
404 / 重复的 /v1
端点中重复填写了版本或完整聊天路径。
将 OpenAI 设为 https://api.uniroute.app/v1。
401 / 密钥无效
Key 不完整、已撤销或缺少权限。
替换为完整有效的 UniRoute API Key。
Cherry Agent 无法使用模型
缺少 Anthropic 端点或端点类型设置。
将 Anthropic 设为 https://api.uniroute.app，并选择端点类型为 Anthropic 的 Claude 模型。
参考资料
相关链接
全部集成 · 管理 API Key · 协议与地址 · 模型价格 · 用量记录