基于ModelArts Studio（MaaS） DeepSeek API和Cherry Studio快速构建个人AI智能助手

操作场景

在人工智能飞速发展的当下，大语言模型（LLMs）已成为推动自然语言处理应用革新的关键力量。DeepSeek作为一系列具有高效计算架构和强大推理能力的大规模语言模型，备受瞩目。

与此同时，为了让用户更便捷地使用这些大语言模型，各种模型调用工具和平台应运而生。Cherry Studio便是其中一款功能强大的开源多模型桌面客户端，支持Windows、macOS和Linux系统。它集成了多种主流大语言模型（例如OpenAI、DeepSeek、Gemini等），并支持本地模型运行。此外，它还具备丰富的功能，例如对话知识库、AI绘画、翻译、多模型切换等。

ModelArts Studio（简称MaaS）服务将DeepSeek系列模型部署到平台，基于昇腾AI云服务进行全面适配和优化，使得精度和性能显著提升。MaaS DeepSeek支持广大开发者在线体验或API调用。更多信息，请参见免费体验MaaS预置服务。

本文介绍如何使用MaaS（大模型即服务平台）DeepSeek API接入Cherry Studio，快速构建个人AI智能助手。

方案架构

图1 方案架构

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

计费影响

本文使用MaaS的免费模型服务，您也可以开通付费服务或付费部署为我的服务使用。更多信息，请参见计费说明，在MaaS预置服务中开通商用服务和使用MaaS部署模型服务。

前提条件

• 已注册华为云账号，并进行实名认证。具体操作，请参见注册华为账号并开通华为云和实名认证。
• 已完成ModelArts委托授权。具体操作，请参见配置ModelArts Studio（MaaS）访问授权。

步骤一：下载并安装Cherry Studio

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

步骤二：获取MaaS DeepSeek对接信息

获取MaaS DeepSeek模型服务的关键信息，用于后续Cherry Studio对接MaaS DeepSeek。

1. 创建API Key，用于调用MaaS DeepSeek模型服务时的鉴权认证。

   最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥。

   1. 登录ModelArts Studio（MaaS）控制台，在顶部导航栏选择“西南-贵阳一”区域。
   2. 在左侧导航栏，单击“API Key管理”。
   3. 在“API Key管理”页面，单击“创建API Key”，填写标签和描述信息后，单击“确定”。

      标签和描述信息在创建完成后，不支持修改。

      表1 创建API Key参数说明

      参数	说明
      标签	自定义API Key的标签。标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符。
      描述	自定义API Key的描述，长度范围为1~100个字符。

   4. 在“您的密钥”对话框，复制密钥并保存至安全位置。
   5. 保存完毕后，单击“关闭”。

      单击“关闭”后将无法再次查看密钥。

2. 获取MaaS DeepSeek模型服务的API地址和模型名称。
   1. 在ModelArts Studio（MaaS）控制台左侧导航栏，单击“在线推理”。
   2. 在“预置服务”页签，单击“免费服务”页签，在DeepSeek服务右侧的“操作”列，单击“调用说明”。
   3. 在“调用说明”页面，可以查看调用该服务需要的基础API地址和模型名称信息，在后续Cherry Studio配置中使用。

步骤三：在Cherry Studio中配置MaaS DeepSeek

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

      表2 添加提供商参数说明

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

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

      参数	说明
      API密钥	步骤二：获取MaaS DeepSeek对接信息中创建的API Key。
      API地址	步骤二：获取MaaS DeepSeek对接信息获取的MaaS服务的基础API地址，需要去掉地址尾部的“/v1/chat/completions”后填入。

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

      参数	说明
      模型 ID	步骤二：获取MaaS DeepSeek对接信息获取的模型名称。
      模型名称	自定义模型名称。
      分组名称	自定义分组名称。

步骤四：在Cherry Studio中使用MaaS DeepSeek

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

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

   图4 模型问答示例
   

常见问题

• 在ModelArts Studio（MaaS） 创建API Key后需要等待多久才能生效？

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

• MaaS如何接入Dify、Cherry Studio、Chatbox？

  MaaS集成了DeepSeek大模型，支持对接多个平台进行AI开发，详情请参见使用ModelArts Studio（MaaS） DeepSeek API搭建AI应用。