Alibaba Cloud Model Studio:Cherry Studio

Use Alibaba Cloud Model Studio models in Cherry Studio.

Quick Start

1. 1

   Get an API key

   Get the API key for your billing plan:

   • Token Plan Personal Edition: Create or view API Key
   • Token Plan Team Edition: Assign a seat and get the API Key
   • Pay-as-you-go: Model Studio API key
   • Coding Plan: Coding Plan API key
2. 2

   Configure the model

   In Cherry Studio, click the settings button in the upper-right corner, click Add under Models, enter a provider name (for example, Bailian), and select OpenAI as the provider type. Configure the following fields for your billing plan:

   Token Plan

   Parameter	Value
   API address	https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   API key	Token Plan Personal Edition or Team Edition API key
   Model	Enter a text generation model supported by Personal Edition or Team Edition

   Pay-as-you-go

   Pay-as-you-go is billed by actual usage. Replace {WorkspaceId} with your Workspace ID. The following example uses Singapore.

   Parameter	Value
   API address	https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   API key	Model Studio API key
   Model	qwen3.8-max or qwen3.8-flash; for available models, see models supported by the OpenAI-compatible API

   Coding Plan

   Parameter	Value
   API address	https://coding-intl.dashscope.aliyuncs.com/v1
   API key	Coding Plan API key
   Model	qwen3.7-plus; for available models, see models supported by Coding Plan

3. 3

   Verify

   Enter the model in Model ID and click Add. Return to the chat, select the model you just added, and send a message. A normal response confirms the configuration.

Error codes

If you encounter errors, see the FAQ for your billing plan:

• Token Plan: Personal Edition FAQ · Team Edition FAQ
• Pay-as-you-go: Error codes
• Coding Plan: Coding Plan FAQ

FAQ

How do I use a savings plan with pay-as-you-go?

The pay-as-you-go setup remains the same: use your general Model Studio API key and Base URL. After you purchase a savings plan, it takes effect automatically and eligible usage is deducted automatically. See Savings plans.

Error 401 Unauthorized

Possible causes:

• The API key does not match the selected billing plan. API keys for Token Plan, Pay-as-you-go, and Coding Plan are not interchangeable.
• The Pay-as-you-go API key and API address are in different regions.

Use the dedicated API key for the selected plan, and make sure the Pay-as-you-go API key matches the region.

No permission error when a RAM subaccount calls a model

RAM subaccounts need permission to call the model. See Workspace management.

Error: The value of the enable_thinking parameter is restricted to True

Cause: This model requires thinking mode, which was not enabled.

Solution: Enable thinking mode in the client.

Charges incurred despite having a free quota when using Pay-as-you-go

Possible causes:

• Region mismatch: The free quota applies only to models in the Singapore region. Using models in other regions incurs charges. Ensure the API address matches your target region. See Free quota for new users.
• Per-model free quota: Each model has its own free quota.
• Data update delay: Free quota data updates hourly. Your quota may be exhausted even if the console shows a remaining balance.

See Identify models with charges and How do I view model invocation records? for details.