调用GetVideoTaskInfo查询视频合成任务详情_虚拟数字人(DVH)-阿里云帮助中心

通过提交任务生成的TaskUuid，查询对应视频合成任务详情。同时支持3D数字人和2D数字人的视频合成任务详情查询。

接口说明

根据在成功提交视频合成任务之后获取到的 TaskUuid 可以通过该接口查询视频合成任务状态，由于视频合成任务是离线运行，所以任务执行时间不定，可能需要调用方能够定时调用该接口查询任务状态，直到任务状态为已完成（成功或者失败），针对成功的任务接口会返回任务合成详情，包含视频和字幕的下载地址，失败的任务会返回失败原因。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
avatar:GetVideoTaskInfo	Read	全部资源 acs:avatar::{#accountId}:*	无	无

请求参数

名称	类型	必填	描述	示例值
TenantId	long	是	从虚拟数字人开放平台中获取的 TenantId	xxxxxx
App	object	是	代表一个业务配置
AppId	string	是	App ID。在开发者中心-实例管理页面获取对应的 appId，参考文档。	3d95xx946a
TaskUuid	string	是	任务 UUID，提交对应视频生成任务时返回的 TaskUuid。	xxxx-xxxx-xxx

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID	xxx-xxx-xxx-xx
Code	string	错误码	502
Message	string	错误消息	这是一个错误
Success	boolean	调用接口是否成功 false: 调用失败。 true：调用成功。	true
Data	object	调用接口结果数据
TaskUuid	string	任务 UUID	xxxx-xxx-xx-xx
Type	string	任务类型： 1: 3D 数字人视频合成。 3: 2D 数字人视频合成。	1
Status	string	任务业务状态： 1: 等待执行 2: 执行中 3: 成功 4：失败 5: 已取消 6: 已过期	1
Process	string	任务执行进度，暂不支持	99
TaskResult	object	任务结果
VideoUrl	string	视频 URL 注意有效期 7 天，请尽快下载保存，过期 URL 将失效	xxx/xxxx/xx.mp4
SubtitlesUrl	string	字幕 URL 注意有效期 7 天，请尽快下载保存，过期 URL 将失效	xxx/xxx/xxx.ass
WordSubtitlesUrl	string	字粒度的时间戳文件，特定任务支持	xxx/xxx/xxx.ass
FailReason	string	失败原因	这是一个失败原因
FailCode	string	失败错误码	20002
VideoDuration	integer	生成视频时长，单位 ms	60992
AlphaUrl	string	mp4 对应的蒙版视频文件	xxx/xxx/xxx-alpha.mp4
PreviewPic	string	视频首帧预览图	xxxxx.png
AttachmentUrl	string	视频附件地址，特定任务支持	xxx.ini

示例

正常返回示例

JSON格式

{
  "RequestId": "xxx-xxx-xxx-xx",
  "Code": "502",
  "Message": "这是一个错误",
  "Success": true,
  "Data": {
    "TaskUuid": "xxxx-xxx-xx-xx",
    "Type": "1",
    "Status": "1",
    "Process": "99",
    "TaskResult": {
      "VideoUrl": "xxx/xxxx/xx.mp4",
      "SubtitlesUrl": "xxx/xxx/xxx.ass",
      "WordSubtitlesUrl": "xxx/xxx/xxx.ass",
      "FailReason": "这是一个失败原因",
      "FailCode": "20002",
      "VideoDuration": 60992,
      "AlphaUrl": "xxx/xxx/xxx-alpha.mp4",
      "PreviewPic": "xxxxx.png",
      "AttachmentUrl": "xxx.ini"
    }
  }
}