Skip to main content
QwenCloud home page
Docs
Administration

Workspaces

Organize users and access

Overview

A workspace is the basic unit for organizing resources, permissions, and billing in QwenCloud. Each workspace has its own set of API keys, model access, and usage quotas. Workspaces let you:
  • Isolate resources between departments, teams, or projects
  • Control which models can be called and set per-model rate limits
  • Manage API keys independently per workspace
  • Track usage and billing separately

Workspaces and regions

Workspaces are managed separately in each region. A workspace, its API keys, and its model permissions exist only in the region where the workspace was created. After you switch regions in the upper-right corner of the console, select or create a workspace in that region. Workspaces in other regions are not copied or deleted; switch back to see them. See Regions and endpoints. Each region has its own default workspace, created automatically when you open that region for the first time.

Create a workspace

1

Select a region

Use the region selector in the upper-right corner of the console to select the region where you want the workspace.
2

Go to the Workspaces page

Go to Settings > Workspaces.
3

Create a workspace

Click Create workspace, enter a workspace name (up to 30 characters), and click Submit.
4

Choose the service deployment scope

In Germany (Frankfurt), China (Hong Kong), Japan (Tokyo), and US (Virginia), select a service deployment scope. Choose a scope with a specific geographic boundary if you have data compliance requirements, or Global for a larger inference resource pool. API keys from the workspace call models in that scope. Singapore and China North 2 (Beijing) need no selection.The scope does not change the Base URL, which contains only the region.
5

Grant model access (optional)

Select Authorize all existing and future models (model calling only) to grant the workspace access to every model, including models launched later. You can change this after creation.
Your account includes a default workspace that is created automatically. In regions that use service deployment scopes, the default workspace uses Global. The scope you select for a workspace cannot be changed after the workspace is created. You can create additional workspaces as needed. The counter on the Create workspace button (such as 3/10) shows how many workspaces you have and the limit. When you reach the limit, the button is disabled.

Manage workspaces

From the Workspaces page, you can:
  • Search: Find workspaces by name or workspace ID.
  • Edit: Click Edit next to a workspace to open the editing panel.
  • Switch: Use the Current Workspace dropdown to filter the view, or use the workspace switcher at the bottom of the sidebar to change your active workspace.
Each workspace shows its name, workspace ID, service deployment scope, and created time. Status labels:
LabelMeaning
CurrentThe active workspace. It determines the data shown on the API Keys and Analytics pages.
DefaultThe account's default workspace, created at sign-up. It cannot be deleted.

Edit a workspace

Click Edit on any workspace to open the editing panel with two sections:

Basic info

  • Workspace Name: Rename the workspace (max 30 characters).
  • Total API Keys: Shows the current number of API keys and the maximum allowed (such as 0/20).

Model Permissions

Control which models can be called using API keys in this workspace. If you selected Authorize all current and future models(model calls only) when creating the workspace, no additional authorization is needed. Otherwise:
  1. Click Edit Models to open the model selection dialog.
  2. Search by model name, or filter by Model Author or model type.
  3. Select the models to add. Use Select All Models on This Page to check every model on the current page.
  4. Set rate limits for each model (Calls / min for RPM and Tokens / min for TPM, when the model supports token-based metering), then click Select (N) to confirm.
  5. Click Submit on the panel to persist the changes.
The RPM and TPM values you set cannot exceed the account-level limits for that model. You can check each model's current limits on the Analytics page.
The model selection dialog is paginated. Selections on one page may not carry over when you navigate to another page. Use search and filters to narrow results, or save after each page.
The default workspace shows All models authorized with account-level rate limits, and its model permissions cannot be changed. To customize model access or rate limits, create a sub-workspace.

Switch workspaces

You can switch your active workspace in two ways:
  • Workspace switcher: Click the workspace name at the bottom of the sidebar to open the switcher. Select the workspace you want to use.
  • Workspaces page: Use the Current Workspace dropdown to filter and select a workspace.
When you switch workspaces, the API Keys page, Analytics, and Monitoring data all reflect the selected workspace, including request logs.

API keys and workspaces

Each API key belongs to one workspace. When calling models through the API, the key determines which workspace's model access and rate limits apply.
  • Default workspace keys can call all available models.
  • Sub-workspace keys can only call models that have been granted to that workspace.
To manage API keys for a specific workspace, switch to it first, then go to the API Keys page.

Limits

ResourceLimit
Workspaces per account10, including the default workspace
API keys per workspace20
Workspace name length30 characters
The default workspace is created automatically and cannot be deleted. It can be renamed.

FAQ

How do I get the workspace ID?

Go to the Workspaces page. The workspace ID is shown in the Workspace ID column of the table. The workspace switcher shows only workspace names, not IDs. You can also find the ID in:
  • Request logs: Open any request's Details, switch to JSON, and read the workspace_id field.
  • Try AI: Open the Try AI page; the workspaceId parameter in the URL is the current workspace ID.

How do I call models from a specific workspace?

Use an API key that belongs to that workspace. The key determines the workspace context for the API call.

How do I restrict which models a team can use?

Create a workspace for the team, click Edit, then use Model Permission to add only the models they need. Any API key in that workspace can only call the allowed models.

How do I set rate limits for a specific model?

When adding models to a workspace, set the Calls / min (RPM) and Tokens / min (TPM) fields for each model before clicking Select (N), then Submit.

Why can't I change model permissions in the default workspace?

You are editing the default workspace. Its model permissions are fixed to All models authorized, so the model selection and rate limit settings are not available.

Can I delete the default workspace?

No. The default workspace cannot be deleted, but you can rename it.