文档中心
aigc_server 数字人 PaaS 服务
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 数字人 PaaS 服务
  • 服务端 API
  • 媒体处理
  • 查询拼接视频任务

服务端 API 版块于4月16日至5月15日升级维护,期间暂停信息更新,如有任何疑问,请联系ZEGO技术支持。

查询拼接视频任务

更新时间: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 技术支持开通服务权限。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈