全驱数字人API接口文档
一、接口概述
全驱数字人API是一站式AI数字人视频生成接口，整合图片数字人图生视频、数字人像生成、虚拟人驱动、唇形同步、对口型播报、2D/3D数字人生成、分身合成等核心能力，支持真人形象复刻、智能口播、动态肢体与面部微调，可广泛应用于短视频制作、虚拟播报、数字分身、AI营销视频、智能解说等场景。
接口支持自定义视频比例、分辨率，搭配音频自动完成唇形匹配与动态渲染，提供任务提交、任务查询、回调通知全流程能力，适配各类业务系统快速接入。
二、基础信息
配置项
详细说明
发布日期
2026-07-05
使用要求
需完成实名认证后方可调用
计费模式
按量计费
免费额度
5次免费调用
请求限制
无每日请求次数限制
请求方式
HTTP GET / POST
返回格式
application/json
接口地址
https://#/api/ai/humanvideo
配套资源
提供API文档、错误码说明、示例代码、在线调试工具
三、请求头部（Header）
参数名称
参数值
说明
Content-Type
application/x-www-form-urlencoded;charset=utf-8
统一请求编码格式
四、计费规则
接口计费分为图片生成视频基础费用和视频唇形对口型费用，组合调用叠加计费，计费精准按量统计。
计费项目
规格
单价
备注
图片生成视频
720p分辨率
1元/次
生成对应分辨率数字人视频
图片生成视频
1080p分辨率
3元/次
高清画质生成，成本更高
数字人对口型
不限分辨率
1元/分钟
按视频有效时长计费
计费示例：生成1分钟720p分辨率数字人口播视频，费用=720p视频生成1元 + 对口型配音1元，合计2元。
五、请求参数说明
参数名
是否必填
参数类型
示例值
参数说明
key
是
string
35kj5jnlj53453kl5j43nj5
接口唯一密钥，在开发者控制台-密钥管理中查看获取
image_url
是
string
https://#/#.jpg
数字人形象图片在线URL，支持jpg、png、webp、bmp、tiff、gif格式
audio_url
是
string
https://#/#.mp3
配音音频在线URL，用于数字人对口型播报
prompt
否
string
数字人自然口播
视频渲染提示词，默认自带最优动态效果：嘴型匹配说话动态、头部微动、呼吸肩动自然、面部无扭曲、柔和运镜，可自定义调整动态风格
ratio
否
string
9:16
视频比例，默认9:16竖屏，支持16:9横屏；建议与原图比例保持一致，适配最佳展示效果
duration
否
string
10
视频时长，默认固定10秒，无需主动传参
resolution
否
string
720p
视频分辨率，默认720p，可选1080p高清模式
type
是
string
start
接口操作类型：start=提交生成任务，query=查询任务结果
task_id
是
string
cc306a3b-3345-491e-bef2-d9ab5cc937e7
任务唯一ID，仅type=query查询任务时必填
callback_url
否
string
https://#/#
任务回调地址，视频生成完成后，系统通过POST请求推送结果至该地址；不填则需主动轮询查询结果
六、音频文件要求
为保障数字人对口型精准度与视频生成成功率，音频文件需满足以下规范：
- 时长限制：音频时长最长不超过100分钟；
- 大小限制：文件体积不超过2G；
- 格式支持：兼容wav、mp3、m4a、wma、ogg主流音频格式，建议使用OSS存储上传音频，保证访问稳定性。
七、调用方式说明
7.1 任务提交（生成视频）
请求示例：https://接口地址?key=你的key，传入图片、音频、分辨率、比例等参数，提交数字人视频生成任务，系统即时返回任务ID。
7.2 任务结果获取
支持两种结果获取方式：
- 回调模式：填写callback_url，任务完成后系统自动POST推送结果；
- 轮询模式：无回调地址时，通过task_id主动轮询接口查询任务状态与视频地址。
八、返回参数说明
参数名
参数类型
参数说明
code
int
接口状态码，200为成功，其他为异常
msg
string
状态描述信息
data
string
请求结果核心数据集
taskId
string
当前任务唯一ID
status
string
任务状态，SUCCESS=生成完成
videoUrl
string
生成完成的数字人视频在线地址
duration
string
生成视频时长（秒）
createTime
string
任务创建时间
updateTime
string
任务更新/完成时间
templateVideoId
string
模型ID，可复用提交后续任务
md5
string
视频文件MD5值，用于文件校验
debug
string/array
调试数据，用于问题排查
exec_time
float
接口执行耗时
user_ip
string
客户端请求IP
九、返回示例
{
    "code": 200,
    "msg": "查询成功",
    "data": {
        "taskId": "eac2d579-a595-41d0-8463-d0b93d6dd5bb",
        "status": "SUCCESS",
        "failedCode": 0,
        "failedMessage": "",
        "videoUrl": "https://#/#.mp4",
        "duration": 3,
        "createTime": "2026-07-12T14:37:45",
        "updateTime": "2026-07-12T14:38:15",
        "subtitleFileUrl": "",
        "templateId": "eac2d579-a595-41d0-8463-d0b93d6dd5bb",
        "templateVideoId": "eac2d579-a595-41d0-8463-d0b93d6dd5bb",
        "md5": "08bf7358d8086d7aae38aefbe8d6aacf"
    }
}
十、功能覆盖范围
本接口全覆盖以下数字人相关能力，一站式满足各类AI视频生成需求：
- 图片数字人视频生成、图生视频、人像动态化合成
- AI数字人智能驱动、唇形精准同步、音频对口型播报
- 2D/3D数字人形象生成、真人数字人分身合成
- 真人数字人智能播报、动态视频渲染制作
十一、配套支持
接口提供完整配套服务，包含标准化错误码说明、可直接复用的示例代码、在线调试工具，同时提供效果演示参考，助力开发者快速接入、调试、上线。

来源：酷虎全驱数字人开放平台