通过 API 调用阿里云百炼的应用(智能体、工作流)时,需提供凭证来指定目标应用及其所属的业务空间:
应用位于默认业务空间,仅需提供 APP ID。
应用位于子业务空间,需同时提供 APP ID 和 Workspace ID。
本文介绍如何在控制台中快速获取这些凭证。更多业务空间相关内容请参考:业务空间权限管理。
目前只能通过控制台手动获取APP ID和Workspace ID,不支持通过 API 或命令行工具(CLI)查询。
获取APP ID
在通过 API 调用任一应用时,都需要提供其唯一的APP ID。
访问应用管理界面;
在应用列表中找到目标应用,复制应用的
APP ID。

获取Workspace ID
Workspace ID是业务空间的唯一标识。在调用子业务空间下的应用或德国(法兰克福)地域下的模型时,API 请求中才必须包含Workspace ID。
获取当前业务空间 ID
适用于快速查找当前登录并使用的业务空间的 ID。
访问阿里云百炼控制台首页,选择目标地域;
再点击页面右上角的
图标;在弹出的对话框中即可查看并复制业务空间ID。
RAM 子账号默认只能查看其已加入的业务空间的 ID。
查询所有业务空间 ID
适用于需要查询或管理主账号下全部业务空间的场景,只能由超级管理员操作。
使用主账号或授权子账号登录阿里云百炼控制台;
单击右上角的
图标,前往业务空间管理界面;在Workspace ID列,查看并复制所需业务空间的 ID。
此操作要求使用主账号,或已授予AliyunBailianFullAccess/AliyunBailianControlFullAccess权限的 RAM 子账号。若无相应权限,访问页面将提示权限不足。关于如何授权,请参考管理权限。
下一步
获取凭证后,即可参考应用调用-DashScope API或应用调用-Responses API文档,构建并发送 API 请求。
常见问题
Q:为什么 RAM 子账号访问“业务空间管理”页面会报错?
A:需要将 RAM 子账号设置为超级管理员才能使用该页面。