# Cherry Studio
Cherry Studio是一款功能强大的开源多模型桌面客户端，支持Windows、macOS和Linux系统。它支持接入多种主流大语言模型（例如OpenAI、DeepSeek、Gemini等），并支持本地模型运行。此外，它还具备丰富的功能，例如对话知识库、AI绘画、翻译、多模型切换等。
MaaS模型即服务部署了多款模型服务，如GLM，Kimi、DeepSeek等系列模型，用户可在Cherry Studio上接入MaaS模型API，快速构建个人AI智能助手。
#### 前提条件
- 已注册华为云账号，并进行实名认证。具体操作请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。
- **已订阅MaaS Token Plan个人版套餐** 。具体操作请参见[快速开始](https://support.huaweicloud.com/Token-plan-maas/tokenplan-maas-0001.html#ZH-CN_TOPIC_0000002583633128__section1953014219367)。
 
#### 约束限制
该功能仅支持"西南-贵阳一"区域。
#### 步骤一：下载并安装Cherry Studio
您可以通过[官方网站](https://cherry-ai.com/)或[开源地址](https://github.com/CherryHQ/cherry-studio/releases/tag/v0.9.24)下载并安装Cherry Studio。
#### 步骤二：在Cherry Studio中配置MaaS模型
![](https://support.huaweicloud.com/Token-plan-maas/public_sys-resources/note_3.0-zh-cn.png)
Cherry Studio界面可在"设置 \> 显示设置"中设置，该文档中的界面只作为指导示例。
1. 在Cherry Studio添加MaaS提供商。
   1. 在Cherry Studio客户端左下角，单击设置图标，在"模型服务"中单击"添加"。
      图1添加提供商   
      ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002629943440.png "点击放大") 
   
   2. 在"添加提供商"对话框，配置提供商名称和提供商类型，然后单击"确定"。
      表1添加提供商参数说明 
      | 参数     | 说明                    |
      |:---|:---|
      | 提供商名称 | 配置为"华为云MaaS"，您可以按需修改。 |
      | 提供商类型   | 配置为"OpenAI"。          |
         
      
    
2. 在模型服务列表中单击刚创建的供应商"华为云MaaS"，参考[表2]，填写API密钥和Token Plan的专属API地址。如[图2]所示。
    表2MaaS 模型对接信息 
   | 参数   | 说明                                                                                                                                                              | 示例                                                                                      |
   |:---|:---|:---|
   | API地址  | 兼容OpenAI接口协议工具：https://api.modelarts-maas.com/plan/v2 注意： 如未使用指定的专属Base URL，将无法使用Token Plan额度，并可能产生额外API请求的费用。 | https://api.modelarts-maas.com/plan/v2                                                   |
   | API密钥 | 请前往[API Key管理页面](https://console.huaweicloud.com/modelarts/?#/model-studio/authmanage)创建。                                                                        | \*\*\*\*\*SOYrkryjO-Jcd-X0-YQIA_oALlv\*\*\*\*\*-xVhElZgwtV3-3aXiuiac6bW\*\*\*\*\*\*\*\* |
      
   图2API配置页面   
   ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002630103406.png "点击放大") 
3. 在供应商"华为云MaaS"中添加模型。
   图3添加模型   
   ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660263151.png "点击放大")
   1. 在"模型"区域，单击"添加"。
   
   2. 在"添加模型"对话框，配置模型ID、模型名称和分组名称，单击"添加模型"。
      表3添加模型参数说明 
      | 参数    | 说明                                                                                                                                                                                                                                                                                                                                                                                                                          |
      |:---|:---|
      | 模型 ID | 获取的模型名称。Token Plan个人版套餐支持以下模型： - GLM-5.1  - Kimi-K2.6  - DeepSeek-V4-Flash   |
      | 模型名称  | 自定义模型名称。                                                                                                                                                                                                                                                                                                                                                                                                                  |
      | 分组名称 | 自定义分组名称。                                                                                                                                                                                                                                                                                                                                                                                                                   |
         
      
   
   3. 模型添加成功后可在模型列表查看，如下图所示。 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660263579.png "点击放大")
      
      
   
   4. 模型添加完成之后，单击"API密钥"后面的"检测"按钮，选择您要检测的模型。 ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660263821.png "点击放大")
      
   
   5. 单击"确定"，如果模型API可成功调用，则页面会有"链接成功"提示。
    
 
#### 步骤三：在Cherry Studio中使用MaaS模型
1. 在Cherry Studio左侧导航栏，单击![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660394455.png)图标，可在顶部换模型，如下图所示。
   图4选择模型   
   ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660384133.png "点击放大")
   也可在下方聊天框中单击![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002660274895.png "点击放大")图标，切换模型，如下图所示。
   ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002629944978.png "点击放大")
   
2. 在下方聊天框中输入文字，开始对话。
   图5模型问答示例   
   ![](https://support.huaweicloud.com/Token-plan-maas/figure/zh-cn_image_0000002629944988.png "点击放大") 
 
#### 常见问题
**在MaaS创建API Key后需要等待多久才能生效？**
MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。