文档中心
aigc_server 数字人 PaaS 服务
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 数字人 PaaS 服务
  • 服务端 API
  • 查询精品数字人
  • 查询数字人补帧包

查询数字人补帧包

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

描述

当您需要将数字人视频 A 与视频 B 拼接为一段视频时,可能会因为视频 A 结尾的动作与视频 B 开头的动作不同,导致拼接后的视频动作不连贯。您可以调用本接口查询获取数字人补帧包,补帧包内含该数字人形象的若干段动作视频。

您需要根据 查询视频合成任务 获取的视频 A 和 B 的 StartIndex,如 775 和 1550,在补帧包中查看文件名为 775-1550 的视频,以便用于视频 A 与视频 B 之间的动作衔接。

如需调用此接口,请先发送邮件至 aigc@zego.im 进行配置。

接口原型

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

请求参数

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

参数 类型 是否必选 描述
MetaHumanId String 是 数字人形象 ID,通过 查询数字人模特列表 获得。

请求示例

  • 请求 URL

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

    {
        "MetaHumanId": "your_metahuman_id"
    }

响应参数

参数 类型 描述
Code
Int
错误码。
Message
String
错误描述。
Data
Object
响应对象。
FrameFillUrl
String
补帧包的下载 URL,访问有效期 24 小时。

响应示例

{
    "Code": 0,
    "Message": "succeed",
    "Data": {
        "FrameFillUrl": "XXXXXXXXXXXX"
    }
}

返回码

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

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

    联系我们

  • 文档反馈