Alibaba Cloud Model Studio:ZCode

Use Alibaba Cloud Model Studio models in ZCode.

Quick Start

1. 1

   Get an API key

   Get the API key for your billing plan:

   • Token Plan: Token Plan API key
   • Pay-as-you-go: Model Studio API key
   • Coding Plan: Coding Plan API key
2. 2

   Add a provider

   In ZCode, open model settings, add a provider at the bottom of the provider list, and enter a custom name.

3. 3

   Select the protocol and Base URL

   ZCode supports the Anthropic and OpenAI protocols. Do not append /chat/completions to the Base URL.

   Token Plan

   • OpenAI Base URL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   • Anthropic Base URL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

   Pay-as-you-go

   Replace {WorkspaceId} with your actual Workspace ID.

   • OpenAI Base URL: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
   • Anthropic Base URL: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic

   Coding Plan

   • OpenAI Base URL: https://coding-intl.dashscope.aliyuncs.com/v1
   • Anthropic Base URL: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
4. 4

   Enter the API key

   Enter the API key for your billing plan.

5. 5

   Enter the model and save

   Enter the model ID for your billing plan, turn on the enable switch, and save:

   • Token Plan: a text generation model supported by Personal Edition or Team Edition
   • Pay-as-you-go: for example, qwen3.8-max or qwen3.8-flash
   • Coding Plan: a supported text generation model
6. 6

   Verify

   Select the model you added in ZCode and send a test message. A model reply confirms the connection.

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.

The model does not appear in the ZCode model list

Confirm that you added the model, turned on the enable switch, and saved the configuration. Return to model settings and check that the provider and model entries are complete.

The model cannot be called or returns 401

Confirm that the API key, Base URL, and model belong to the same plan. API keys for Token Plan, Coding Plan, and pay-as-you-go are not interchangeable. For pay-as-you-go, also confirm that {WorkspaceId} has been replaced with the Workspace ID for the correct region.

The request returns 404 or an endpoint does not exist error

Check whether /chat/completions was appended to the Base URL. ZCode uses the Base URL without that path.