Use Alibaba Cloud Model Studio models in ZCode.
Quick Start
- 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
Add a provider
In ZCode, open model settings, add a provider at the bottom of the provider list, and enter a custom name. - 3
Select the protocol and Base URL
ZCode supports the Anthropic and OpenAI protocols. Do not append/chat/completionsto the Base URL.- Token Plan
- Pay-as-you-go
- Coding 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
- 4
Enter the API key
Enter the API key for your billing plan. - 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-maxorqwen3.8-flash - Coding Plan: a supported text generation model
- 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?
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
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
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
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.