调用阿里云百炼API时,需要使用 APP ID
来指定应用。若应用位于子空间内,还需提供 Workspace ID
。本文介绍如何在控制台中快速获取这两个ID,为后续构建API请求做好准备。
适用范围
目前只能通过控制台手动获取APP ID
和Workspace ID
,不支持通过 API 或命令行工具(CLI)查询。
如何获取
获取APP ID
在通过 API 调用任一应用(智能体、工作流)时,都需要提供其唯一的APP ID
。
1. 登录阿里云百炼控制台。
2. 在左侧导航栏,选择应用管理。
3. 在应用列表中找到目标应用,其对应的应用ID列即为APP ID
。
获取Workspace ID
Workspace ID
是业务空间的唯一标识。仅在调用子业务空间下的应用时,API 请求中才必须包含Workspace ID
。如果应用位于默认业务空间,则调用时无需提供此参数。
以下介绍两种获取Workspace ID
的场景。
场景一:获取当前所在业务空间的 ID
此方法适用于快速查找当前登录并使用的业务空间的 ID。
前往阿里云百炼控制台首页;
单击界面左下角的
图标,再单击业务空间详情;
在弹出的对话框中即可查看并复制业务空间ID。
RAM 子账号默认只能查看其已加入的业务空间的 ID。
场景二:获取主账号下所有业务空间的 ID
此方法适用于需要管理或查询主账号下全部业务空间 ID 的场景,通常由管理员操作。
1. 使用主账号或授权子账号登录阿里云百炼控制台;
2. 单击右上角的图标,访问业务空间管理界面;
3. 在业务空间列表中,即可在Workspace ID列查看并复制各空间的Workspace ID
。
此操作要求使用主账号,或已授予AliyunBailianFullAccess
/AliyunBailianControlFullAccess
权限的 RAM 子账号。若无相应权限,访问页面将提示权限不足。关于如何授权,请参考管理权限(全局管理)。
下一步
获取 ID 后,即可参考DashScope API 参考或Responses API 参考文档,构建并发送 API 请求。
常见问题
Q:调用 API 时,是否总是需要提供 Workspace ID?
A:不是。当您调用的应用位于一个子业务空间时,必须在 API 请求中提供Workspace ID
。当您调用的应用位于默认业务空间时,API 请求中无需包含Workspace ID
参数。
Q:为什么 RAM 子账号访问“业务空间管理”页面会报错?
A:访问业务空间管理页面需要权限。如果 RAM 子账号未获得相应授权,访问时会收到权限不足的错误。解决方案:请联系主账号管理员,为该 RAM 子账号授予AliyunBailianFullAccess
或 AliyunBailianControlFullAccess
权限策略。具体授权操作,请参考管理权限(全局管理)。