管理模型权限、速率限制和 API Key
概述
业务空间是千问AI平台中管理资源、权限和计费的基本单元。每个业务空间拥有独立的:
- API Key 和用量上下文
- 模型访问权限和模型级速率限制
- 用量配额(API Key 数量等)
创建业务空间
1
进入业务空间页面
前往设置 > 业务空间。
2
创建业务空间
点击创建业务空间,输入业务空间名称(最多 30 个字符)。可勾选授权全部现有及后续新增模型(仅限模型调用);不勾选时,创建后需在编辑页面配置可用模型。然后点击提交。
管理业务空间
在业务空间页面,您可以查看所有业务空间的列表,包括名称、业务空间 ID 和创建时间。
- 搜索:按名称或业务空间 ID 查找业务空间。
- 编辑:点击业务空间旁的编辑,打开编辑面板。
| 标签 | 说明 |
|---|---|
| 当前 | 当前活跃的业务空间,影响 API Key、用量分析等页面的数据范围 |
| 默认 | 账号默认业务空间,注册时自动创建,不可删除 |
编辑业务空间
点击任意业务空间的编辑按钮,打开编辑面板。
基本信息
- 业务空间名称:重命名业务空间(最多 30 个字符)。
- API Key 总数:显示当前 API Key 数量及上限(例如 0/20),只读。
模型权限
控制该业务空间的 API Key 可调用哪些模型。默认业务空间的模型权限固定为已授权全部模型,使用账号级别的速率限制,无法自定义。如需自定义模型访问权限和速率限制,请创建子业务空间。
对于非默认业务空间,模型权限区域显示已授权模型数量,并提供选择模型按钮:
- 点击选择模型打开模型选择对话框。
- 按模型名称搜索,或使用模型作者和模型类型筛选。
- 勾选要添加的模型,使用全选本页模型可批量选择当前页的所有模型。
- 为每个模型设置速率限制:
- 调用/分钟(RPM):每分钟最大 API 请求数。
- Token/分钟(TPM):每分钟最大处理 Token 数。部分模型类型(如图像生成)不使用 Token 计量,可能不显示此字段。
- 点击选择 (N) 确认,然后在面板上点击提交。
模型选择对话框采用分页显示,切换页面时之前的选择可能不会保留。建议使用搜索和筛选缩小结果范围,或在每页选择后保存。
切换业务空间
在业务空间页面,使用当前业务空间下拉菜单选择目标业务空间。
切换业务空间后,API Key、用量分析、请求日志等数据都会切换为所选业务空间的数据。
API Key 与业务空间
每个 API Key 归属于一个业务空间。通过 API 调用模型时,所使用的 API Key 决定了哪个业务空间的模型访问权限和速率限制生效。
- 默认业务空间的 API Key 可调用所有可用模型。
- 子业务空间的 API Key 只能调用该业务空间已授权的模型。
限制
| 资源 | 限制 |
|---|---|
| 每个账号的业务空间数 | 20(包含默认业务空间) |
| 每个业务空间的 API Key 数 | 20 |
| 业务空间名称长度 | 30 个字符 |
常见问题
如何获取业务空间 ID?
前往业务空间页面,业务空间 ID 列会显示对应的 ID,格式形如 llm-xxxxxxxxxxxx 或 ws-xxxxxxxxxxxx。控制台左侧边栏的业务空间切换器只显示名称,不显示 ID。
其他获取方式:
- 请求日志:在请求日志中打开任意请求的详情,切换到 Json,
workspace_id字段即业务空间 ID。 - 模型体验:打开模型体验页面,地址栏中的
workspaceId参数为当前业务空间 ID。