Chatbox
Use Alibaba Cloud Model Studio models in Chatbox.
Quick Start
- 1
Get an API key
Get the API key for your billing plan:
- Token Plan Personal Edition: Create or view API Key
- Token Plan Team Edition: Assign a seat and get the API Key
- Pay-as-you-go: Model Studio API key
- Coding Plan: Coding Plan API key
- 2
Configure the model
In Chatbox, click Settings at the bottom left, click Model Provider, and click Add at the bottom. Enter a Name, set API Mode to OpenAI API Compatible, and click Add. Configure the following fields for your billing plan:
Token Plan
Parameter Value API host https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API key Token Plan Personal Edition or Team Edition API key Model Enter a text generation model supported by Personal Edition or Team Edition Pay-as-you-go
Pay-as-you-go is billed by actual usage. Replace
{WorkspaceId}with your Workspace ID. The following example uses China North 2 (Beijing).Parameter Value API host https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API key Model Studio API key Model qwen3.8-maxorqwen3.8-flash; for available models, see models supported by the OpenAI-compatible APICoding Plan
Parameter Value API host https://coding.dashscope.aliyuncs.com/v1API key Coding Plan API key Model qwen3.7-plus; for available models, see models supported by Coding PlanLeave the API path empty.
- 3
Verify
Click New, enter the model from the table in Model ID, and save. Select the model in the chat and send "Hello". A normal response confirms the configuration.
Error codes
If you encounter errors during configuration, see the FAQ for your billing plan:
- Token Plan: Personal Edition FAQ · Team Edition FAQ
- Pay-as-you-go: Error codes
- Coding Plan: Coding Plan FAQ
FAQ
How do I use savings plans and resource plans 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 or resource plan, it takes effect automatically and eligible usage is deducted automatically. See Savings plans and resource plans.
Error 401 Unauthorized
Possible causes:
- The API key does not match the selected billing plan. API keys for Token Plan, Pay-as-you-go, and Coding Plan are not interchangeable.
- The API key is incomplete or contains extra spaces.
Use the dedicated API key for the selected plan, and copy the complete key again.