If you have multiple business or scenarios that use Alibaba Cloud Model Studio, create separate workspaces to manage them independently. This lets you control the models that each workspace can call, implement cost allocation, and isolate their respective user data.
Workspace types
Model Studio provides two types of workspaces: default workspace and sub-workspaces.
Item | Default workspace | Sub-workspace |
Creation method | Automatically created when you activate Model Studio. | Manually created by an Alibaba Cloud account or a RAM user with management permissions. |
Uniqueness | Globally unique under an Alibaba Cloud account. | Multiple sub-workspaces can exist under one Alibaba Cloud account. |
Model permissions in the workspace | Can call all models without authorization. | Requires authorization to call specified models. |
Special identifier | In Workspaces page (Singapore or Beijing), this workspace is marked as Default. | In Workspace page, this workspace has no Default mark. |
Getting started
Create a new workspace
You must use an Alibaba Cloud account for this operation. If you use a RAM user, the RAM user must be granted management permissions by the Alibaba Cloud account.
After a workspace is created, you can change its name but you cannot delete it.
You can create a separate workspace, also known as a sub-workspace, for a new service or scenario. The models, resource costs, and user data within a workspace are completely isolated from other workspaces.
Procedure:
In the upper-right corner, click Add Workspace. In the dialog box that appears, enter a name for the workspace.
Click OK.
What to do next: Manage workspace members and permissions
Get a workspace ID
The workspace ID is a unique identifier for a workspace that does not change after it is generated. For example: llm-7c72iiw36kd8****.
To retrieve the IDs of all workspaces under an Alibaba Cloud account: Go to the Workspaces (Singapore or Beijing) page.
You must use an Alibaba Cloud account or a RAM user with management permissions. Otherwise, an error is reported when you try to access the page.
To retrieve the ID of the current workspace: On the Model Studio homepage (Singapore or Beijing), click
in the lower-left corner, and then click Workspace Details.RAM users without administrative permissions can only view the IDs of the sub-workspaces they have joined.
Switch between workspaces
Workspaces are independent of each other. You cannot view the content of all workspaces at the same time. Instead, you must switch to a specific workspace to view its models, cost information, and user data.
How to switch: On the Model Studio homepage (Singapore or Beijing), click
in the lower-left corner. You can then view and switch to different workspaces in the list.
If the desired workspace is not in the list, it means the current RAM user has not joined that workspace. How to join a workspace.
Authorize a sub-workspace to call models
You must use an Alibaba Cloud account for this operation. If you use a RAM user, the RAM user must be granted management permissions and added as a member of the workspace that requires model authorization.
A sub-workspace can invoke a specific model, such as qwen-plus, only after it is granted the required permissions for that model.
Procedure:
Go to the Workspaces (Singapore or Beijing) page. Find the sub-workspace that you want to authorize and click Authorization & Throttling Settings.

Find the desired model and click Edit on the right.

Enable the required permissions and click Save.
If the workspace has been authorized before, you do not need to authorize it again.

Configure rate limiting for model calling
You must use an Alibaba Cloud account for this operation. If you use a RAM user, the RAM user must be granted management permissions and added as a member of the workspace.
To ensure fair model calling across different services or scenarios, you can set independent calling rate limits for different sub-workspaces.
Entry point: On the Workspaces (Singapore or Beijing) page, find the desired sub-workspace and click Authorization & Throttling Settings on the right.
How it works:
Within a workspace, rate limiting is controlled at the model level. For example, for the
qwen-plusmodel, the system counts the total number of requests toqwen-plusfrom all API keys in the workspace and applies limiting based on this count.Model calling limit is measured in two independent ways: Request Number Limit and Token Limit. Limiting is triggered as soon as either limit is reached.
For example, assume the request rate limit is 20 requests per minute (RPM) and the token rate limit is 100,000 tokens per minute (TPM). If you send 20 requests to the model within one minute and consume only 1,000 tokens (which is below the 100,000 TPM limit), limiting is still triggered because the number of requests has reached the RPM limit.
Key limitations:
The default workspace does not support limiting settings. The limits for all models in this workspace are the same as the Alibaba Cloud account limits.
The total number of calls to a model across all workspaces cannot exceed the Alibaba Cloud account rate limit for that model.
Model calling limiting applies to real-time calls, but not to batch inference tasks.
You cannot configure limiting for a specific member within a workspace.
Going live
Workspace planning strategies
By environment (recommended): Create separate workspaces for development, testing, pre-production, and production environments to achieve strict environment fencing.
project-dev-workspaceproject-test-workspaceproject-prod-workspace
By line-of-business: Create separate workspaces for different business departments in your company, such as marketing, after-sales, and design. This simplifies permission and cost management.
marketing-team-workspacecustomer-team-workspace
Rate limiting strategy
Allocate the total quota of your Alibaba Cloud account to each workspace proportionally. Reserve a portion as a buffer to handle traffic bursts.
Example: The total account quota is 1,000 RPM. The allocation plan is as follows:
project-prod-workspace: 600 RPM (60%)project-test-workspace: 200 RPM (20%)project-dev-workspace: 100 RPM (10%)Reserved buffer: 100 RPM (10%)
Security and permissions
The default workspace has permissions to call all models, which poses a significant security risk.
Recommendations:
Avoid using the default workspace for production services.
Use the default workspace only for early testing or administrator operations.
Create and manage separate sub-workspaces for all official services, such as development, testing, and production.
Quotas and limits
Maximum number of workspaces per Alibaba Cloud account: 10 in the Singapore region and 20 in the Beijing region. Both limits include one default workspace.
Deletion not supported: Workspaces cannot be deleted after they are created.
Billing
Creating and managing workspaces is free of charge.
Charges are incurred based on the resource consumption within each workspace, such as model calls.