模型聚合服务平台

外观

Cherry Studio ​

应用介绍 ​

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

准备信息 ​

接入前请准备：

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

保护 API Key

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

1. 打开模型服务设置 ​

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

Cherry Studio 首页，箭头指向右上角的设置按钮

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

在设置中选择模型服务，再点击底部的添加按钮

2. 添加 OpenAI 提供商 ​

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

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

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

填写提供商名称，类型选择 OpenAI，然后点击确定

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 已能连接平台。

填写 API Key 和 Base URL，然后点击检测

地址预览

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

4. 获取并添加模型 ​

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

搜索模型 ID，并点击模型所在行右侧的加号

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

模型已成功添加到提供商

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

5. 发起测试对话 ​

返回 Cherry Studio 首页：

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

第三方应用风险

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

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