使用前必读
数字内容生产线（MetaStudio）解决方案，提供数字人视频与直播、智能交互等服务，使能千行百业场景应用。
您可以使用本文档提供的API对华为云MetaStudio服务进行相关操作，如形象制作、声音制作、视频制作等。支持的全部操作请参见API概览。
在调用华为云MetaStudio服务的API之前，请确保已经充分了解华为云MetaStudio服务的相关概念，详细信息请参见产品介绍。
MetaStudio服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。
配置用户信息
使用MetaStudio之前需配置用户信息，请您提交工单，并附上账号信息（projectId）联系华为云技术工程师为您配置相关账号的白名单。
使用API调用声音的限制说明
用户使用视频直播或智能交互接口调用音色时，需要先确认能否在MetaStudio控制台的视频直播间编辑界面或智能交互对话设置页面，选到当前音色。
如果界面正常展示且可以选择此音色使用，说明接口可以正常调用此音色，否则接口无法调用。
API流控
数字内容生产线服务对服务端API设置了调用次数限制，避免出现短时间内重复调用API，服务中断的情况。
如果调用API时，返回“APIGW.0308”错误信息，是触发了API流控限制。需要参考下述表格中的流控值，调整调用API的间隔时间，控制请求的发送速度；或者等待一段时间后，再发送API请求。
“APIGW”开头的错误码列表，详见错误码说明。
|
接口分类 |
接口名称 |
单租户接口流控 （华北-北京四） |
单租户接口流控 （华东-上海一） |
单租户接口流控 （亚太-新加坡） |
|---|---|---|---|---|
|
数字资产管理 |
创建资产 |
10次/秒 |
5次/秒 |
5次/秒 |
|
查询资产列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新资产 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
删除资产 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
查询资产详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
恢复被删除的资产 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
批量资产操作 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
查询资产概要 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询资产复制信息 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
复制资产 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
文件管理 |
创建文件并获取上传URL |
10次/秒 |
5次/秒 |
5次/秒 |
|
删除文件 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
确认文件已上传 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
创建大文件 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
视频制作剧本管理 |
创建视频制作剧本 |
10次/秒 |
5次/秒 |
5次/秒 |
|
查询视频制作剧本列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询视频制作剧本详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新视频制作剧本 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
删除视频制作剧本 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
复制视频制作剧本 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
数字人视频制作管理 |
查询视频制作任务列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
分身数字人视频制作管理 |
创建分身数字人视频制作任务 |
5次/秒 |
3次/秒 |
3次/秒 |
|
查询分身数字人视频制作任务详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
取消等待中的分身数字人视频制作任务 |
5次/秒 |
3次/秒 |
3次/秒 |
|
|
分身数字人字幕文件生成管理 |
创建分身数字人视频字幕文件 |
5次/秒 |
3次/秒 |
3次/秒 |
|
查询分身数字人视频字幕文件详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
智能直播间管理 |
创建智能直播间 |
5次/秒 |
3次/秒 |
3次/秒 |
|
查询智能直播间列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询智能直播剧本详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新智能直播间信息 |
5次/秒 |
3次/秒 |
3次/秒 |
|
|
删除智能直播间 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
创建智能直播间互动规则库 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询智能直播间互动规则库列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新智能直播间互动规则库 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除智能直播间互动规则库 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
直播任务管理 |
启动数字人智能直播任务 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询某个智能直播间下直播任务列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询数字人智能直播任务详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
结束数字人智能直播任务 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
控制数字人直播过程 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询租户所有数字人直播任务列表 |
10次/秒 |
5次/秒 |
5次/秒 |
|
|
上报直播间事件 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
直播商品管理 |
创建商品 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询商品列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新商品 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询商品详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
删除商品 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
商品资产组合配置 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
第三方直播平台管理 |
创建第三方直播平台 |
1次/秒 |
1次/秒 |
1次/秒 |
|
更新第三方直播平台信息 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
删除第三方直播平台信息 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
查询直播平台列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询第三方直播平台信息 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询第三方直播平台商品列表 |
5次/秒 |
3次/秒 |
3次/秒 |
|
|
智能交互数字人对话管理 |
创建智能交互对话 |
5次/秒 |
3次/秒 |
- |
|
查询智能交互对话列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询智能交互对话详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
更新智能交互对话信息 |
5次/秒 |
3次/秒 |
- |
|
|
删除智能交互对话 |
5次/秒 |
3次/秒 |
- |
|
|
智能交互数字人对话任务管理 |
创建对话链接 |
5次/秒 |
3次/秒 |
- |
|
启动数字人智能交互任务 |
5次/秒 |
3次/秒 |
- |
|
|
结束数字人智能交互任务 |
5次/秒 |
3次/秒 |
- |
|
|
查询数字人智能交互任务 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
智能交互数字人应用管理 |
创建应用 |
5次/秒 |
3次/秒 |
- |
|
查询应用列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询应用详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改应用 |
5次/秒 |
10次/秒 |
- |
|
|
删除应用 |
5次/秒 |
3次/秒 |
- |
|
|
智能交互数字人鉴权码管理 |
创建一次性鉴权码 |
20次/秒 |
10次/秒 |
- |
|
智能交互数字人激活码管理 |
创建激活码 |
5次/秒 |
3次/秒 |
- |
|
查询激活码列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询激活码详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改激活码 |
5次/秒 |
3次/秒 |
- |
|
|
重置激活码 |
5次/秒 |
3次/秒 |
- |
|
|
删除激活码 |
5次/秒 |
3次/秒 |
- |
|
|
智能交互数字人知识库技能管理 |
创建知识库技能 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询知识库技能列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改知识库技能 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询知识库技能详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
删除知识库技能 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
导出知识库技能 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
智能交互数字人知识库意图管理 |
创建知识库意图 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询知识库意图列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询知识库意图详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改知识库意图 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除知识库意图 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
创建知识库意图和问法 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
智能交互数字人知识库问法管理 |
创建知识库问法 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询知识库问法列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询知识库问法详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改知识库问法 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除知识库问法 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
批量创建知识库问法 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
批量修改知识库问法 |
1次/秒 |
1次/秒 |
1次/秒 |
|
|
智能交互数字人欢迎词管理 |
创建欢迎词 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询欢迎词列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询欢迎词详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改欢迎词 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除欢迎词 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
修改欢迎词功能开关 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询欢迎词功能开关 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
智能交互数字人热点问题管理 |
创建热点问题 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询热点问题列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询热点问题详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改热点问题 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除热点问题 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
智能交互数字人热词记录管理 |
创建热词记录 |
4次/秒 |
3次/秒 |
3次/秒 |
|
查询热词记录列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询配置热词记录详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
修改热词记录 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
删除热词记录 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
修改热词功能开关 |
4次/秒 |
3次/秒 |
3次/秒 |
|
|
查询热词功能开关 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
智能交互数字人委托管理 |
查询委托 |
20次/秒 |
10次/秒 |
10次/秒 |
|
创建委托 |
1次/秒 |
1次/秒 |
- |
|
|
删除委托 |
1次/秒 |
1次/秒 |
- |
|
|
分身形象制作管理 |
创建分身数字人模型训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
查询分身数字人模型训练任务列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
查询分身数字人模型训练任务详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
删除分身数字人模型训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
更新分身数字人模型训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
租户执行分身数字人模型训练任务命令 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
声音制作任务管理 |
查询用户配置的个性化音频时长 |
20次/秒 |
10次/秒 |
10次/秒 |
|
创建基础版语音训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
创建进阶版语音训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
创建高级版语音训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
查询语音训练任务列表 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
提交语音训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
查询语音训练任务详情 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
删除语音训练任务 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
查询任务操作日志 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
获取语音文件上传地址 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
获取语音训练任务审核结果 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
设置任务批次 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
确认在线录音结果 |
10次/秒 |
3次/秒 |
3次/秒 |
|
|
获取在线录音确认结果 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
语音合成管理 |
创建TTS试听任务 |
5次/秒 |
3次/秒 |
3次/秒 |
|
获取TTS试听文件 |
20次/秒 |
10次/秒 |
10次/秒 |
|
|
创建TTS异步任务 |
5次/秒 |
3次/秒 |
3次/秒 |
|
|
获取TTS异步任务 |
20次/秒 |
10次/秒 |
10次/秒 |
|
接口分类 |
接口名称 |
单租户接口流控 |
系统流控 |
|---|---|---|---|
|
租户管理 |
查看租户资源用量信息 |
10次/秒 |
20次/秒 |
|
查看租户资源列表 |
10次/秒 |
20次/秒 |
|
|
统计时间段内资源数量 |
10次/秒 |
20次/秒 |
基本概念
- 账号
用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。
- 用户
由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。
在“我的凭证”下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。
- 区域
指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。
- 可用区
一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。
- 项目
区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。
图1 项目隔离模型
