Cherry Studio

​

Install Cherry Studio

Download and install Cherry Studio from the Cherry Studio download page.

​

Configure credentials

Open Cherry Studio, click the settings button in the upper-right corner, and then click Add in the Model Service section. Enter a provider name (for example, Token Plan Team Edition) and select OpenAI as the provider type. Model Studio offers the following billing plans. Choose based on your needs:

• Token Plan Personal Edition: Deducts personal Credits based on token consumption.
• Token Plan Team Edition: Seat-based subscription that deducts Credits based on token consumption.
• Coding Plan: Fixed monthly subscription billed by the number of model calls.
• Pay-as-you-go: Postpaid billing based on actual usage.

​

Token Plan Personal Edition

Parameter	Description
API key	Token Plan Personal Edition dedicated API key.
API address	https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
Model	For available models, see Token Plan Personal Edition supported models.

​

Token Plan Team Edition

Parameter	Description
API key	Token Plan Team Edition dedicated .
API address
Model	For available models, see Token Plan Team Edition supported models.

​

Coding Plan

Parameter	Description
API key	Coding Plan dedicated API key.
API address	https://coding-intl.dashscope.aliyuncs.com/v1
Model	For available models, see Coding Plan supported models.

​

Pay-as-you-go

Parameter	Description
API key	Enter your Model Studio API Key.
API address	Enter the URL for your region, replace {WorkspaceId} in the URL with your actual Workspace ID: China (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 US (Virginia): https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
Model	Enter a supported model.

​

Verify configuration

In the Model ID field, enter the ID of the model you want to use, and then click Add. Return to the chat interface and ask a question. A valid response confirms the setup.

If you are a RAM user, see RAM user authorization to check model access permissions.

​

FAQ

​

Error codes

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

• Pay-as-you-go: Error code troubleshooting
• Coding Plan: Coding Plan FAQ
• Token Plan Personal Edition: Token Plan FAQ
• Token Plan Team Edition: Token Plan Team Edition FAQ

​

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.