Cherry Studio

前提条件

• 已注册华为云账号，并进行实名认证。具体操作请参见注册华为账号并开通华为云和实名认证。
• 已订阅MaaS Token Plan个人版套餐。具体操作请参见快速开始。

约束限制

该功能仅支持“西南-贵阳一”区域。

步骤一：下载并安装Cherry Studio

您可以通过官方网站或开源地址下载并安装Cherry Studio。

步骤二：在Cherry Studio中配置MaaS模型

Cherry Studio界面可在“设置 > 显示设置”中设置，该文档中的界面只作为指导示例。

1. 在Cherry Studio添加MaaS提供商。
   1. 在Cherry Studio客户端左下角，单击设置图标，在“模型服务”中单击“添加”。
      图1 添加提供商
      
   2. 在“添加提供商”对话框，配置提供商名称和提供商类型，然后单击“确定”。

      表1 添加提供商参数说明

      参数	说明
      提供商名称	配置为“华为云MaaS”，您可以按需修改。
      提供商类型	配置为“OpenAI”。

2. 在模型服务列表中单击刚创建的供应商“华为云MaaS”，参考表2，填写API密钥和Token Plan的专属API地址。如图2所示。

   表2 MaaS 模型对接信息

   参数	说明	示例
   API地址	兼容OpenAI接口协议工具：https://api.modelarts-maas.com/plan/v2 注意： 如未使用指定的专属Base URL，将无法使用Token Plan额度，并可能产生额外API请求的费用。	https://api.modelarts-maas.com/plan/v2
   API密钥	请前往API Key管理页面创建。	*****SOYrkryjO-Jcd-X0-YQIA_oALlv*****-xVhElZgwtV3-3aXiuiac6bW********

   图2 API配置页面
   
3. 在供应商“华为云MaaS”中添加模型。
   图3 添加模型
   
   1. 在“模型”区域，单击“添加”。
   2. 在“添加模型”对话框，配置模型ID、模型名称和分组名称，单击“添加模型”。

      表3 添加模型参数说明

      参数	说明
      模型 ID	获取的模型名称。Token Plan个人版套餐支持以下模型： GLM-5 GLM-5.1 Kimi-K2.6 DeepSeek-V3.2 DeepSeek-V4-Flash
      模型名称	自定义模型名称。
      分组名称	自定义分组名称。

   3. 模型添加成功后可在模型列表查看，如下图所示。

      

   4. 模型添加完成之后，单击“API密钥”后面的“检测”按钮，选择您要检测的模型。

      

   5. 单击“确定”，如果模型API可成功调用，则页面会有“链接成功”提示。

步骤三：在Cherry Studio中使用MaaS模型

1. 在Cherry Studio左侧导航栏，单击图标，可在顶部换模型，如下图所示。
   图4 选择模型
   

   也可在下方聊天框中单击图标，切换模型，如下图所示。

   

2. 在下方聊天框中输入文字，开始对话。
   图5 模型问答示例
   

常见问题

在MaaS创建API Key后需要等待多久才能生效？

MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。