# Cherry Studio 在人工智能飞速发展的当下，大语言模型（LLMs）已成为推动自然语言处理应用革新的关键力量。DeepSeek作为一系列具有高效计算架构和强大推理能力的大规模语言模型，备受瞩目。 与此同时，为了让用户更便捷地使用这些大语言模型，各种模型调用工具和平台应运而生。Cherry Studio便是其中一款功能强大的开源多模型桌面客户端，支持Windows、macOS和Linux系统。它集成了多种主流大语言模型（例如OpenAI、DeepSeek、Gemini等），并支持本地模型运行。此外，它还具备丰富的功能，例如对话知识库、AI绘画、翻译、多模型切换等。 MaaS服务将DeepSeek系列模型部署到平台，基于昇腾AI云服务进行全面适配和优化，使得精度和性能显著提升。MaaS DeepSeek支持广大开发者进行在线体验或API调用。 本文介绍如何使用MaaS的DeepSeek API接入Cherry Studio，快速构建个人AI智能助手。 #### 方案架构 图1方案架构 ![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002397302049.png "点击放大") - 用户通过Cherry Studio提交问题请求。 - Cherry Studio将请求发送给MaaS DeepSeek。 - MaaS DeepSeek大语言模型处理请求后将结果返回给Cherry Studio。 - Cherry Studio将结果优化处理后通过界面返回给用户。 #### 计费说明 本文支持使用预置服务进行调用。计费如下： 预置服务：提供商用级别的推理API服务，无需等待部署，开通后您可直接体验或调用模型服务，按Tokens数量计费。详细信息，请参见[推理服务计费项](https://support.huaweicloud.com/price-maas/price-maas-0001.html)。 #### 约束限制 该功能仅支持"西南-贵阳一"区域。 #### 前提条件 - 已注册华为云账号，并进行实名认证。具体操作，请参见[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)和[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。 - 请参考[配置MaaS访问授权](https://support.huaweicloud.com/permission-maas/maas-modelarts-0016.html)进行委托授权。 #### 步骤一：下载并安装Cherry Studio 您可以通过[官方网站](https://cherry-ai.com/)或[开源地址](https://github.com/CherryHQ/cherry-studio/releases/tag/v0.9.24)下载并安装Cherry Studio。 #### 步骤二：获取MaaS DeepSeek对接信息 获取MaaS DeepSeek模型服务的关键信息，用于后续Cherry Studio对接MaaS DeepSeek。 - [使用预置服务] 1. 在[MaaS控制台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)左侧导航栏，选择"模型推理 \> 在线推理"。 2. 在"预置服务"页签，在目标服务右侧的"操作"列，单击"开通服务"。 3. 在开通预置模型服务对话框，按需勾选预置服务，勾选"我已阅读并同意上述说明，及《MaaS 模型即服务声明》"，单击"一键开通"。 勾选目标预置服务后，会自动开通该服务下的所有模型版本。 4. 在已开通的预置服务右侧，单击"操作"列下的"API调用"，选择版本。 5. 在"API调用说明"页面，单击"创建 API Key"，配置相关参数，单击"确定"。 API Key用于接口的鉴权认证，最多可创建30个密钥。API Key的标签在创建完成后，不支持修改。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥。关于API Key参数说明，请参见[创建API Key](https://support.huaweicloud.com/model-call-maas/model-call-049.html)。 图2创建API Key ![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002554769221.png "点击放大") 6. 在"您的API Key"对话框，复制密钥并保存至安全位置。保存完毕后，单击"我已保存，确认关闭"。 单击"我已保存，确认关闭"后将无法再次查看密钥。 7. 在"API调用说明"页面，查看调用该服务需要的API地址和模型名称信息，在后续Cherry Studio配置中使用。 #### 步骤三：在Cherry Studio中配置MaaS DeepSeek 1. 在Cherry Studio添加MaaS提供商。 1. 在Cherry Studio客户端左下角，单击设置图标，在"模型服务"中单击"添加"。 图3添加提供商 ![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002397382157.png "点击放大") 2. 在"添加提供商"对话框，配置提供商名称和提供商类型，然后单击"确定"。 表1添加提供商参数说明 | 参数 | 说明 | |:---|:---| | 提供商名称 | 配置为"华为云MaaS"，您可以按需修改。 | | 提供商类型 | 配置为"OpenAI"。 | 2. 在Cherry Studio添加MaaS DeepSeekAPI密钥和API地址。 1. 在Cherry Studio客户端左下角，单击设置图标。 2. 在"设置"页面，找到"华为云MaaS"选项，配置API密钥和API地址。 | 参数 | 说明 | |:---|:---| | API密钥 | [步骤二]中创建的API Key。 | | API地址 | [步骤二]获取的MaaS服务的基础API地址，需要去掉地址尾部的"/v1/chat/completions"后填入。 | 3. 在Cherry Studio添加模型。 1. 在"模型"区域，单击"添加"。 2. 在"添加模型"对话框，配置模型ID、模型名称和分组名称，单击"添加模型"。 | 参数 | 说明 | |:---|:---| | 模型 ID | [步骤二]获取的模型名称。 | | 模型名称 | 自定义模型名称。 | | 分组名称 | 自定义分组名称。 | #### 步骤四：在Cherry Studio中使用MaaS DeepSeek 1. 在Cherry Studio左侧导航栏，单击![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002363822176.png "点击放大")图标，选择已配置好的模型。 图4选择模型 ![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002363662284.png "点击放大") 2. 在文本框中输入文字，开始对话。 您也可以选择顶部菜单中的模型名字切换模型。 图5模型问答示例 ![](https://support.huaweicloud.com/bestpractice-maas/figure/zh-cn_image_0000002397382153.png "点击放大") #### 常见问题 **在MaaS创建API Key后需要等待多久才能生效？** MaaS API Key在创建后不会立即生效，通常需要等待几分钟才能生效。