Cherry Studio

应用介绍

Cherry Studio 是一款桌面 AI 客户端，可用于日常问答、内容创作、文件分析以及在同一界面中管理和切换多个模型。它适合需要图形化操作或经常对比不同模型回答的用户。Cherry Studio 支持 OpenAI 兼容接口，可以按下面的步骤接入模型聚合服务平台。

准备信息

接入前请准备：

Base URL：https://ai.example.edu.cn/v1
API Key：你的 API Key
模型名称：以模型聚合服务平台“模型广场”中显示的模型标识为准

保护 API Key

API Key 相当于账号密码。不要把它发给他人，也不要出现在截图、聊天记录或公开仓库中。本文截图里的密钥均已隐藏。

1. 打开模型服务设置

打开 Cherry Studio，在首页右上角点击 齿轮图标（设置）。

进入设置后，在左侧选择 模型服务。然后在服务商列表底部点击 添加。

2. 添加 OpenAI 提供商

在弹出的“添加提供商”窗口中：

1. 提供商名称：填写一个便于识别的名称，例如 校园 AI。
2. 提供商类型：选择 OpenAI。
3. 点击 确定。

提供商名称只用于在 Cherry Studio 中区分不同服务，不会影响接口调用。

3. 填写 API Key 和 API 地址

选中刚创建的提供商，在右侧填写连接信息。

Cherry Studio 字段	填写内容
API 密钥	你的 API Key，例如 sk-...
API 地址	https://ai.example.edu.cn/v1

填写时请注意：

• API 地址末尾应包含 /v1。
• 不要填写 Markdown 链接、引号或 BASE_URL=，只填写地址本身。
• API Key 前后不要带空格或引号，也不要填写 API_KEY=。
• 确认右上角的提供商开关处于开启状态。

填写完成后，点击 API 密钥输入框右侧的 检测。检测通过表示 Cherry Studio 已能连接平台。

地址预览

Cherry Studio 会在 API 地址下方预览实际请求地址。正常情况下应类似于 https://ai.example.edu.cn/v1/chat/completions。如果预览中出现 /v1/v1/，说明 API 地址重复填写了 /v1。

4. 获取并添加模型

点击 获取模型列表。在弹出的模型列表中找到要使用的模型，并点击该模型所在行右侧的 +。可通过顶部搜索框按模型 ID 搜索。

添加后的模型会显示在当前提供商的“模型”区域。确认需要使用的模型均已出现。

如果无法自动获取列表，也可以点击“获取模型列表”右侧的 +，手动填写模型广场中给出的完整模型标识。模型标识需要完全一致，注意大小写、连字符以及是否有多余空格。

5. 发起测试对话

返回 Cherry Studio 首页：

1. 点击对话顶部当前模型的名称。
2. 选择刚才添加的提供商和模型。
3. 输入一条不含敏感信息的测试消息，例如“你好，请用一句话介绍你自己”。
4. 收到正常回复即表示接入完成。

第三方应用风险

Cherry Studio 可能读取你在对话中上传的文件和输入的内容。请只安装可信来源的客户端，不要提交密钥、证书、个人隐私或未经授权的业务数据。

配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时，请查看常见问题（FAQ）。