GlobalAiOpc

DigitalHuman - 提交任务

提交数字人口型驱动视频生成任务

POST/kyyReactApiServer/v1/digitalHuman/videos

DigitalHuman 提交任务

提交数字人口型驱动视频生成任务。接口接收音频地址和视频地址,生成与音频匹配口型的数字人视频。
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

modelbodystring必填
模型名称,默认 kyy_digitalHuman
audioUrlbodystring必填
音频地址。资源链接需要使用网络资源,不能使用本地资源,资源链接不要带中文。
支持格式:mp4mp3wavm4aaar
videoUrlbodystring必填
视频地址。资源链接需要使用网络资源,不能使用本地资源,资源链接不要带中文。
modelVersionbodyinteger
模型版本。
  • 1:牙齿更清晰,针对大脸场景表现更好
  • 2:口型匹配更好,咬字速度更快,建议默认选择
sideFacebodyinteger
侧脸优化参数。如果视频是侧脸很严重的视频,传值 1
非特殊情况,默认不传或者传 0,不传的效果最好。
tiltedFacebodyinteger
歪头优化参数。如果视频人物是正脸、歪头,嘴巴是歪的,传值 1
非特殊情况,默认不传或者传 0,不传的效果最好。

响应参数

idstring
任务 ID,用于后续查询任务状态。
objectstring
对象类型,固定为 video
createdinteger
任务创建时间戳。
modelstring
使用的模型名称。
statusstring
任务状态,创建后通常为 queued
errorstring
错误信息,失败时返回。