文档中心
数字人 PaaS 服务
服务端 API
照片数字人
创建照片数字人异步视频合成任务

创建图片数字人异步视频合成任务

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

描述

调用本接口，通过配置已生成的图片形象及驱动方式，异步合成图片数字人视频。

接口原型

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

请求参数

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

参数	类型	是否必选	描述
MetaHuman	Object	是	数字人形象配置。
MetaHumanId	String	是	数字人形象 ID，在创建图片数字人时生成。
Driver	Object	是	驱动配置。
DriverType	Number	是	驱动方式。 1：文本驱动。 2：音频驱动。
TimbreId	String	DriverType 为 1 时，必填	音色 ID。可通过查询音色列表，了解当前数字人支持的音色。
Text	String	DriverType 为 1 时，必填	文本内容。不超过 1800 个字。支持 SSML 标记语言。
SpeechRate	Number	否	语速，取值范围为 [-500, 500]，默认值 0。数值越大，声音越快。
PitchRate	Number	否	语调，取值范围为 [-500, 500]，默认值 0。数值越大，声音越尖。
Volume	Number	否	音量，取值范围为 [1, 100]，默认值 50。数值越大，声音越大。
AudioUrl	String	DriverType 为 2 时，必填	音频 URL 绝对链接，只支持 wav 格式音频，用户自定义传入。

请求示例

请求 URL

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

请求消息体

{
    "MetaHuman": { 
    "MetaHumanId": "2b8994f0-b31d-4d87-ad23-1613e1762260"   
    },
    "Driver": { 
    "DriverType": 1,      
    "Text":"今天天气不错", 
    "TimbreId": "347da32f-38c5-4689-b19d-210436a83860"
    }
}

响应参数

参数	类型	描述
Code	Number	返回码。
Message	String	操作结果描述。
Data	Object	响应对象。
TaskId	String	视频合成任务 ID，获取任务 ID 后，请查询异步视频合成任务时传入此 ID。

响应成功示例

{
    "Code": 0,
    "Message": "success",
    "Data": {
      "TaskId": "1a19bf09-f8f6-45f2-bb7a-bfa4f07b227d" 
   } 
}

响应失败示例

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

返回码

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

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