Cherry Studio

Large language models (LLMs) are now essential for advancing natural language processing applications. The DeepSeek series offers LLMs designed for efficiency and strong performance.

To simplify their use, several tools and platforms have been developed. Among them, Cherry Studio stands out as a versatile open-source desktop application compatible with Windows, macOS, and Linux. It combines popular LLMs like OpenAI, DeepSeek, and Gemini, enabling both cloud-based and local operations. Its features include dialog knowledge bases, AI painting, translation, and seamless model switching.

MaaS integrates DeepSeek models into its platform and enhances their accuracy and efficiency using AI Compute Service. Developers can test these models through API calls.

This guide explains how to access Cherry Studio with MaaS DeepSeek APIs to create your own AI assistant swiftly.

Solution Architecture

Figure 1 Solution architecture
Click to enlarge

The user submits a request through Cherry Studio.
Cherry Studio sends the request to MaaS DeepSeek.
MaaS DeepSeek processes the request and returns the results to Cherry Studio.
Cherry Studio optimizes the results and returns them to the user.

Billing

The built-in services can be used for calling. The services are billed based on the number of tokens used:

You can directly experience or call the model service for inference without waiting for deployment. You are billed based on the number of tokens. For details, see Inference Service Billing Items.

Constraints

This function is only available in the CN-Hong Kong region.

Prerequisites

You have registered a HUAWEI ID. For details, see Signing Up for a HUAWEI ID and Enabling Huawei Cloud Services.
For details, see Configuring MaaS Access Permissions.

Step 1: Downloading and Installing Cherry Studio

Download Cherry Studio from the official website or open-source address.

Step 2: Obtaining MaaS DeepSeek Interconnection Information

Obtain key details about the target MaaS DeepSeek model service for connecting with Cherry Studio.

Using a Built-in Service

In the navigation pane of the MaaS console, choose Model Inference > Real-time inference.
Click the Built-in Services tab. In the Operation column of the target service, click Subscribe.
In the displayed dialog box, select built-in services as required, select I have read and agree to this statement and MaaS Service Agreement, and click Subscribe.
Selecting a built-in service will subscribe to all its model versions.
Click View Call Description in the Operation column of the subscribed built-in service. Select a version.
In the View Call Description dialog box, click Create API Key, set related parameters, and click OK.
API keys are used for API authentication. You can create up to 30 keys. After an API key is created, its tag cannot be changed. Each key is displayed only once after creation. Keep it secure. If the key is lost, it cannot be retrieved. In this case, create a new API key. For details about the API key parameters, see Creating an API Key.
In the Your API Key dialog box, copy the key and store it securely. After the key is saved, click Saved. Confirm and Close.
After you click Saved. Confirm and Close, the key cannot be viewed again.
Check the API URL and model name in the View Call Description dialog box. You will need these for the next steps in configuring Cherry Studio.

Step 3: Configuring MaaS DeepSeek in Cherry Studio

Add a MaaS provider in Cherry Studio.
1. In the lower left corner of the Cherry Studio client, click the settings icon and click Add in Model Provider.
  Figure 2 Adding a provider
2. Set the provider name and provider type and click OK.
  
  Table 1 Parameters for adding a provider
  
  Parameter
  
  Description
  
  Provider Name
  
  Enter MaaS, which can be changed as needed.
  
  Provider Type
  
  Set this parameter to OpenAI.

**Table 1** Parameters for adding a provider
Parameter	Description
Provider Name	Enter MaaS, which can be changed as needed.
Provider Type	Set this parameter to OpenAI.

Add the MaaS DeepSeek API key and API URL in Cherry Studio.

In the lower left corner of the Cherry Studio client, click the settings icon.

Click Huawei Cloud MaaS and configure the API key and API URL.

Parameter	Description
API Key	Select the API key created in Step 2.
API Host	Enter the basic API address of the MaaS service obtained in Step 2. Remove /v1/chat/completions from the end of the address.

Add a model to Cherry Studio.
1. In the Models area, click Add.
2. Set the model ID, model name, and group name, and click Add Model.
  
  Parameter
  
  Description
  
  Model ID
  
  Model name obtained in Step 2.
  
  Model
  
  Custom model name
  
  Group Name
  
  Custom group name

Parameter	Description
Model ID	Model name obtained in Step 2.
Model	Custom model name
Group Name	Custom group name

Step 4: Using MaaS DeepSeek in Cherry Studio

In the navigation pane of Cherry Studio, click and select the configured model.
Figure 3 Selecting a model
Enter message in the text box to start a conversation.
Choose the model name in the top menu to switch models.

Figure 4 Model Q&A example