文档中心
数字人 PaaS 服务
服务端 API
媒体处理
查询拼接视频任务

查询拼接视频任务

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

描述

调用本接口查询拼接视频任务，获取拼接视频相关地址。

接口原型

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

请求参数

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

参数	类型	是否必选	描述
TaskId	String	是	任务 ID。

请求示例

请求 URL

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

请求消息体

{
    "TaskId":"1a19bf09-f8f6-45f2-bb7a-bfa4f07b227d"
}

响应参数

参数	类型	描述
Code	Int	返回码。
Message	String	操作结果描述。
Data	Object	响应对象。
Status	Int	任务状态： 0：待生成。 1：生成中。 2：成功。 3：失败。
VideoUrl	String	拼接视频链接。
CoverUrl	String	拼接视频封面链接。
AudioUrl	String	拼接视频的音频链接。
FailReason	String	失败原因。若合成视频链接有错误，请确保视频链接符合要求，若符合要求后拼接视频失败，请联系 ZEGO 技术支持处理。

响应示例

请求成功的响应示例：

{
    "Code": 0,
    "Message": "success",
    "Data": {
        "Status":2, 
        "VideoUrl": "videoUrl", 
        "CoverUrl": "coverUrl",
        "AudioUrl": "audioUrl", 
        "FailReason": "" 
    } 
}

请求失败的响应示例：

 {
  "Code": 400010001,
  "Message": "service not available"
 }

返回码

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

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