文档中心
数字人 PaaS 服务
服务端 API
精品数字人异步合成
查询视频合成任务

查询视频合成任务

更新时间：2025-04-15 19:16

描述

调用本接口，查询指定视频合成任务的状态，获取相关视频、音频和字幕下载 URL，以及视频起始索引（用户获取补帧包）。

接口原型

请求方法：POST
中国大陆正式环境请求地址：https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanVideo
传输协议：HTTPS
调用频率限制：10 次/秒

请求参数

以下请求参数列表仅列出了接口请求参数，公共参数列表请参考调用方式 - 公共请求参数。

参数	类型	是否必选	描述
TaskId	String	是	视频合成任务 ID，创建视频合成任务后获取。

请求示例

请求 URL

https://aigc-api.zegotech.cn/?Action=DescribeMetaHumanVideo
&AppId=1234567890
&SignatureNonce=15215528852396
&Timestamp=1234567890
&Signature=7a2c0f11145fb760d607a07b54825013
&SignatureVersion=2.0

请求消息体
```
{
    "TaskId": "your_task_id"
}
```

响应参数

参数	类型	描述
Code	Int	错误码。
Message	String	错误描述。
Data	Object	响应对象。
Status	Int	视频合成任务状态。 1：TTS 处理中。 2：TTS 处理失败。 3：视频合成中。 4：视频合成失败。 5：视频合成成功。 6：字幕处理中。
VideoUrl	String	合成视频的 URL，访问有效期 24 小时。
AudioUrl	String	合成语音的 URL，访问有效期 24 小时。
CoverUrl	String	合成视频的首帧图片 URL，访问期24小时。
SubtitleUrl	String	字幕文件的 URL，访问有效期 24 小时。
FailReason	String	合成失败原因。
StartIndex	Int	视频起始索引。拼接两个视频时，需先查询数字人补帧包，参考相关视频的此参数，索引其中缺失的动作。例如，视频 A 的 StartIndex 为 775，视频 B 的 StartIndex 为 1550，则可在补帧包文件夹中，找到文件名为 775-1550 的视频，以便用于视频 A 与视频 B 之间的动作衔接。
Duration	Int	视频时长，单位：秒。
Deduction	Int	抵扣时长，基于视频时长和抵扣系数所得。具体抵扣系数，请联系 ZEGO 商务人员。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "Status": 5,
        "VideoUrl": "XXXXXXXXXXXX",
        "AudioUrl": "XXXXXXXXXXXX",
        "CoverUrl": "XXXXXXXXXXXX",
        "SubtitleUrl": "XXXXXXXXXXXX",
        "FailReason": "",
        "StartIndex": 775,
        "Duration": 10,
        "Deduction": 58
    }
}

返回码

以下仅列出了常见的接口业务逻辑相关的返回码，完整返回码请参考全局返回码。

返回码	说明	处理建议
0	成功。	-
100000004	签名过期。	请重新生成签名。
100000005	签名错误。	请确认生成签名的参数是否正确。
400000001	输入参数无效。	请根据 Message 提示，调整对应参数的取值。
400000002	数字人 PaaS 服务权限未开通。	请联系 ZEGO 技术支持开通服务权限。
400000005	未找到任务。	请确认设置的 TaskId 是否正确。
400010000	系统错误。	请联系 ZEGO 技术支持处理。