Use QwenCloud 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: QwenCloud 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/completions to the Base URL.- Token Plan
- Pay-as-you-go
- OpenAI Base URL:
https://token-plan.maas.qwencloudapi.com/compatible-mode/v1 - Anthropic Base URL:
https://token-plan.maas.qwencloudapi.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 Individual or Team Edition
- Pay-as-you-go: for example,
qwen3.8-maxorqwen3.8-flash
6
Verify
Select the model you added in ZCode and send a test message. A model reply confirms the connection.
FAQ
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. Token Plan and pay-as-you-go API keys are not interchangeable. For pay-as-you-go, also confirm that the API key is from the same region as the Base URL.
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.