调用SubmitAudioTo3DAvatarVideoTask提交3D音频合成视频任务

提交根据一段wav音频文件生成3D数字人视频任务，该接口会立即返回一个TaskUuid作为本次提交任务的唯一id，后续可以根据TaskUuid调用查询和取消任务接口。

接口说明

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

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

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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
avatar:SubmitAudioTo3DAvatarVideoTask	create	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
TenantId	long	是	租户 ID，从虚拟数字人开放平台中获取的 TenantId	xxxx
App	object	是	App 信息，代表一个业务配置
AppId	string	是	App ID。在开发者中心-实例管理页面获取对应的 appId，参考文档。	3d95xx946a
Title	string	是	提交的视频合成的任务标题，最长不超过 32 个字符	这是一个示例标题
VideoInfo	object	否	视频配置
Resolution	integer	否	生成的视频分辨率，目前支持： 1：720 * 1280（竖屏） 2：1280 * 720（横屏） 3：1080 * 1920（竖屏） 4：1920 * 1080（横屏）	1
IsAlpha	boolean	否	是否需要透明通道，默认 false true：开启透明通道，视频格式可通过 AlphaFormat 指定，支持 webm、mov、mp4 false：不开启透明通道，视频格式为 mp4	false
BackgroundImageUrl	string	否	有效可访问的 url 背景图片地址，背景图片的分辨率必须要与生成的视频分辨率保持一致目前支持 jpg，jpeg，png 的图片格式	可访问的公网url地址
AlphaFormat	integer	否	透明通道格式，默认值 1 1：webm 2：mov 3：mp4 注意当 isAlpha 为 false 时，该字段忽略。mov 格式的透明视频文件大小会非常大，不推荐使用，建议使用 webm 或者 mp4。	1
AvatarInfo	object	否	数字人相关配置
Locate	integer	否	数字人机位 0: 全身近景机位，默认机位 1: 头部近景机位 2: 全身远景机位 3: 半身近景机位 4: 半身远景机位 5: 左边近景机位 6: 右边近景机位具体每个机位的效果预览可以参考： 3D 数字人视频合成使用指南	0
Angle	integer	否	数字人角度 0: 正面，默认角度 1: 左侧 30 度 2: 右侧 30 度具体每个角度的效果预览可以参考： 3D 数字人视频合成使用指南	0
Code	string	否	人物 code 警告目前音频合成功能只支持部分人物：Bonnie、Stella、Daisy，以及基于这三个人物新建的数字人。	CH_xxxxxxx
IndustryCode	string	否	行业 code，默认值：default default - 默认通用 kefu - 客服行业 live - 直播场景	default
Url	string	是	音频的地址 url，要求音频时长小于 30 分钟，采样率 16K，单声道，单采样点位深 16bit	可访问的公网url地址
Callback	boolean	否	本次视频合成任务是否需要事件回调，默认 false 不回调。平台支持在任务开始和任务结束时进行事件回调，具体可参考文档：数字人回调事件通知。	false
CallbackParams	string	否	回调时需要透传的一些参数，json 格式字符串，callback=false 时不生效。	{ "xxx": "xxx" }
ExtParams	string	否	一些扩展参数。	{"xxx": "xxx"}
AudioInfo	object	否	音频相关配置。
SampleRate	integer	否	输出音频采样率（单位: Hz）。枚举值： 16000：16000。 24000：24000。 48000：48000。	16000

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID	13E0445E-CA7F-5DD3-9B0F-D4B39E0180F7
Success	boolean	是否成功	true
Code	string	错误码	10050008
Message	string	错误消息	这个一个错误消息。
Data	object	调用结果数据
TaskUuid	string	任务唯一 uuid，后续用来查询任务详细请，请务必保存好	xxxx-xxx-xx-xx

示例

正常返回示例

JSON格式

{
  "RequestId": "13E0445E-CA7F-5DD3-9B0F-D4B39E0180F7",
  "Success": true,
  "Code": "10050008",
  "Message": "这个一个错误消息。",
  "Data": {
    "TaskUuid": "xxxx-xxx-xx-xx"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-01-08	OpenAPI 入参发生变更	查看变更详情
2023-08-01	OpenAPI 返回结构发生变更	查看变更详情
2023-07-05	API 内部配置变更，不影响调用	查看变更详情
2023-06-25	OpenAPI 入参发生变更	查看变更详情