文档中心
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=DescribeImageMetaHumanVideo
  • 传输协议:HTTPS
  • 调用频率限制:10 次/秒

请求参数

本接口只需传入公共参数,公共参数列表请参考 调用方式 - 公共请求参数。

参数 类型 是否必选 描述
TaskId
String
是
视频合成任务 ID,由 创建图片数字人异步视频合成任务 后获取。

请求示例

  • 请求 URL

    https://aigc-api.zegotech.cn/?Action=DescribeImageMetaHumanVideo
    &AppId=1234567890
    &SignatureNonce=15215528852396
    &Timestamp=1234567890
    &Signature=7a2c0f11145fb760d607a07b54825013
    &SignatureVersion=2.0
  • 请求消息体

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

响应参数

参数 类型 描述
Code
Number
返回码。
Message
String
操作结果描述。
Data
Object
响应对象。
Status
Number
视频合成任务状态。

  • 1:TTS 处理中。
  • 2:TTS 处理失败。
  • 3:视频合成中。
  • 4:视频合成失败。
  • 5:视频合成成功。
VideoUrl
String
合成视频的 URL,访问有效期 24 小时。
AudioUrl
String
合成语音的 URL,访问有效期 24 小时。
FailReason
String
合成失败原因。
Duration
Number
视频时长,单位:秒。
Deduction
Number
抵扣时长,基于视频时长和抵扣系数所得。具体抵扣系数,请联系 ZEGO 商务获取。

响应成功示例

{
    "Code": 0,
    "Message": "success",
    "Data": {
      "Status":5,
      "VideoUrl": "video-url", 
      "AudioUrl": "audio-url", 
      "FailReason": "", 
      "Duration": 10, 
      "Deduction":35  
   } 
}

响应失败示例

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

返回码

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

返回码 说明 处理建议
0 成功。 -
100000004 签名过期。 请重新生成签名。
100000005 签名错误。 请确认生成签名的参数是否正确。
400000001 输入参数无效。 请根据 Message 提示,调整对应参数的取值。
400000002 数字人 PaaS 服务未开通。 请联系 ZEGO 技术支持开通权限。
400000005 未找到任务。 请确认设置的 TaskId 是否正确。
400010000 系统错误。 请联系 ZEGO 技术支持处理。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈