SubmitAudioTo3DAvatarVideoTask_虚拟数字人开放平台_API文档-阿里云OpenAPI开发者门户

接口说明

提交根据一段 wav 音频离线生成 3D 数字人视频任务，该接口会立即返回一个 TaskUuid 作为本次提交任务的唯一 id，后续可以根据 TaskUuid 调用查询视频合成任务详情接口查询对应的任务的状态，当任务状态为已完成时可以获取到对应视频的下载地址，进行视频下载。在任务状态为未开始情况下，也可以通过 TaskUuid 调用取消视频合成任务接口，取消该任务。

说明参考 3D 数字人视频合成使用指南了解完整的 3D 视频合成接入流程。

警告目前音频合成功能只支持部分人物：Bonnie、Stella、Daisy，以及基于这三个人物新建的数字人。

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

avatar:SubmitAudioTo3DAvatarVideoTask	Create	全部资源 *	无	无

请求参数

字段名称	字段详情
TenantIdinteger<int64>	租户 ID，从虚拟数字人开放平台中获取的 TenantId 注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:xxxx
Appobject	App 信息，代表一个业务配置
Titlestring	提交的视频合成的任务标题，最长不超过 32 个字符示例值:这是一个示例标题
VideoInfoobject	视频配置
AvatarInfoobject	数字人相关配置
Urlstring	音频的地址 url，要求音频时长小于 30 分钟，采样率 16K，单声道，单采样点位深 16bit 示例值:可访问的公网url地址
Callbackboolean	本次视频合成任务是否需要事件回调，默认 false 不回调。平台支持在任务开始和任务结束时进行事件回调，具体可参考文档：数字人回调事件通知。示例值:false
CallbackParamsstring	回调时需要透传的一些参数，json 格式字符串，callback=false 时不生效。示例值:{ "xxx": "xxx" }
ExtParamsstring	一些扩展参数。示例值:{"xxx": "xxx"}
AudioInfoobject	音频相关配置。

返回参数

字段名称	字段详情
RequestIdstring	请求 ID 示例值:13E0445E-CA7F-5DD3-9B0F-D4B39E0180F7
Successboolean	是否成功示例值:true
Codestring	错误码示例值:10050008
Messagestring	错误消息示例值:这个一个错误消息。
Dataobject	调用结果数据

返回示例

变更历史

	变更时间	变更内容概要	操作
	2024-01-08	新增请求参数AudioInfo
	2023-08-01	变更请求参数VideoInfo 变更返回参数
	2023-07-05	变更请求参数AvatarInfo
	2023-06-25	新增请求参数Callback 新增请求参数CallbackParams 新增请求参数ExtParams