> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwencloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cherry Studio

> Open-source AI desktop client

Connect it to QwenCloud via Token Plan (Personal Edition), Token Plan (Team Edition), or pay-as-you-go billing.

## Install Cherry Studio

Go to the [Cherry Studio download page](https://www.cherry-ai.com/download), download the installation package for your operating system, and complete the installation.

## Configure credentials

Open Cherry Studio, click the settings button in the upper-right corner, and in the **Model Service** section click **Add**. Enter a provider name (for example, Token Plan (Team Edition)) and select OpenAI as the provider type.

### Token Plan (Personal Edition)

| Parameter       | Description                                                                                                                                     |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **API key**     | Token Plan (Personal Edition) dedicated [API key](https://home.qwencloud.com/api-keys).                                                         |
| **API address** | `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`                                                                                   |
| **Model**       | For available models, see Token Plan (Personal Edition) [supported models](/token-plan/personal/token-plan-personal-overview#supported-models). |

### Token Plan (Team Edition)

| Parameter       | Description                                                                                                                         |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| **API key**     | Enter the Token Plan (Team Edition) dedicated [API key](https://home.qwencloud.com/api-keys).                                       |
| **API address** | `https://token-plan.maas.qwencloudapi.com/compatible-mode/v1`                                                                       |
| **Model**       | For available models, see Token Plan (Team Edition) [supported models](/token-plan/team/token-plan-team-overview#supported-models). |

### Pay-as-you-go

The following uses the Singapore (ap-southeast-1) endpoint. For another region, replace ap-southeast-1 and use an API key from that region. See [Regions and endpoints](/developer-guides/getting-started/regions).

| Parameter       | Description                                                                          |
| --------------- | ------------------------------------------------------------------------------------ |
| **API key**     | Enter your [QwenCloud API Key](https://home.qwencloud.com/api-keys).                 |
| **API address** | `https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1`                    |
| **Model**       | Enter a [supported model](/developer-guides/getting-started/text-generation-models). |

## Verify configuration

In the **Model ID** field, enter the model you want to use (for example, `qwen3.7-max`), and click **Add**. Return to the chat interface, enter any question, and confirm that the model responds normally. If it does, the configuration is complete.

## FAQ

### Error codes

If you encounter errors during configuration, refer to the FAQ documentation for the corresponding billing plan:

- Pay-as-you-go: [Error codes and troubleshooting](/api-reference/preparation/error-messages)
- Token Plan (Personal Edition): [Token Plan FAQ](/token-plan/personal/token-plan-personal-faq)
- Token Plan (Team Edition): [Token Plan (Team Edition) FAQ](/token-plan/team/token-plan-team-faq)

### Error: The value of the enable\_thinking parameter is restricted to True

**Cause**: This model only supports thinking mode, but thinking mode was not enabled when the model was called.

**Solution**: Enable thinking mode in the client.

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

Possible causes:

- **Incorrect API address**: The free quota requires using the correct QwenCloud API address (`https://ap-southeast-1.maas.qwencloudapi.com/compatible-mode/v1`). Check that the **API address** in your configuration is correct. For details, see [Free quota](/resources/free-quota).
- **Per-model free quota**: The free quota for each model is calculated independently and cannot be shared across models.
- **Data update delay**: The console updates free quota data hourly. Your free quota may already be exhausted even if the console still shows a remaining balance.