Cherry Studio

方案架构

图1 方案架构

• 用户通过Cherry Studio提交问题请求。
• Cherry Studio将请求发送给MaaS 模型。
• MaaS模型处理请求后将结果返回给Cherry Studio。
• Cherry Studio将结果优化处理后通过界面返回给用户。

计费说明

按Tokens数量计费。详细信息，请参见推理服务计费项。

约束限制

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

前提条件

• 已注册华为云账号，并进行实名认证。具体操作，请参见注册华为云账号和实名认证。
• 请参考配置MaaS访问授权进行委托授权。
• 已开通预置服务，或已创建接入点。具体操作，请参见开通预置服务或创建自定义接入点。

步骤一：下载并安装Cherry Studio

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

步骤二：获取MaaS 模型API对接信息

获取MaaS模型服务的关键信息（模型ID、API Key和API地址），用于后续Cherry Studio对接MaaS模型API。

• 获取模型ID和API地址
  1. 进入MaaS在线推理页面，默认进入“预置服务”页面，也可切换至“自定义接入点”页面，如下图所示：
     图2 在线推理页面
     

  2. 在模型列表的“操作”列，单击“API调用”，选择版本，进入“API调用说明”页面，获取API地址和模型ID，如下图所示：

     

• 获取API Key

  如果已有API Key，可直接使用。如果没有，可前往API Key管理页面新建。

步骤三：在Cherry Studio中配置MaaS模型信息

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

      表1 添加提供商参数说明

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

2. 在Cherry Studio添加MaaS模型API密钥和API地址。
   1. 在Cherry Studio客户端左下角，单击设置图标。
   2. 在“设置”页面，找到“华为云MaaS”选项，配置API密钥和API地址。

      参数	说明
      API密钥	步骤二中创建的API Key。
      API地址	https://api.modelarts-maas.com/v2 或 https://api.modelarts-maas.com/openai/v1

3. 在Cherry Studio添加模型。
   1. 在“模型”区域，单击按钮。
   2. 在“添加模型”对话框，配置模型ID、模型名称和分组名称，单击“添加模型”。

      参数	说明
      模型ID	步骤二获取的模型名称。
      模型名称	自定义模型名称。
      分组名称	自定义分组名称。

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

1. 在Cherry Studio左侧导航栏，单击图标，选择已配置好的模型。
   图4 选择模型
   
2. 在文本框中输入文字，开始对话。

   您也可以选择顶部菜单中的模型名字切换模型。

   图5 模型问答示例
   

常见问题

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

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