对口型
调用本接口,创建一个对口型任务。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
包含多个字段,用于指定视频、口型对应内容等
显示子属性
隐藏子属性
生成视频的模式,可选值如下:
· text2video:文本生成视频模式
· audio2video:音频生成视频模式
通过可灵AI生成的视频的ID,说明:
(1)用于指定视频、判断视频是否可用于对口型服务
(2)与video_url参数,只能选择其中一个填写,不能同时为空,也不能同时有值
(3)仅支持使用30天内生成的5秒视频和10秒视频,超过10秒的视频不支持对口型
所上传视频的获取链接,说明:
(1)用于指定视频,并判断视频是否可用于对口型服务
(2)与video_id参数,只能选择其中一个填写,不能同时为空,也不能同时有值
(3)视频文件支持.mp4/.mov,文件大小不超过100MB,视频时长不超过10s且不短于2s,仅支持720p和1080p、长宽的边长均位于720px~1920px之间,上述校验不通过会返回错误码等信息
(4)系统会校验视频内容,如有问题会返回错误码等信息
生成对口型视频的文本内容,说明:
(1)当mode参数值为text2video时,该参数必填
(2)文本内容最大长度120,内容过长会返回错误码等信息
(3)系统会校验文本内容,如有问题会返回错误码等信息
音色ID,说明:
(1)当mode参数值为text2video时,该参数必填
(2)系统提供多种音色可供选择,具体音色效果、音色ID、音色语种对应关系,请查看相关说明
(3)音色试听不支持自定义文案
(4)音色试听文件命名规范:音色名称#音色ID#音色语种
音色语种,与音色ID对应,说明:
(1)当mode值为text2video时,该参数必填
(2)可选值如下:zh 或 en
(3)音色语种与音色ID对应,请查看相关说明
语速,说明:
(1)当mode值为text2video时,该参数必填
(2)有效范围0.8~2.0,精确至小数点后1位,超出部分将自动四舍五入
使用音频文件生成对口型视频时,传输音频文件的方式,说明:
(1)当mode参数值为audio2video时,该参数必填
(2)可选值如下:
· file:表示上传文件模式
· url:表示提供下载链接模式
音频文件本地路径,说明:
(1)当audio_type参数值为file时,该参数必填
(2)音频文件支持.mp3/.wav/.m4a/.acc,文件大小不超过5MB,Base64编码,格式不匹配或文件过大会返回错误码等信息
(3)系统会校验音频内容,如有问题会返回错误码等信息
音频文件下载url,说明:
(1)当audio_type参数值为url时,该参数必填
(2)音频文件支持.mp3/.wav/.m4a/.acc,文件大小不超过5MB,格式不匹配或文件过大会返回错误码等信息
(3)系统会校验音频内容,如有问题会返回错误码等信息
POST /beta/video/generations/kling/lipsync HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"input": {
"mode": "text2video",
"text": "在这个快节奏的时代,我们往往忽略了身边的美好。停下脚步,你会发现,生活处处充满惊喜。无论是晨曦的第一缕阳光,还是夜晚的点点繁星,都是大自然赋予我们的宝贵财富。",
"video_id": "8b0d44bd-***2c52688530",
"voice_id": "genshin_vindi2",
"voice_language": "zh",
"voice_speed": 2
}
}
示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/kling/lipsync' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"input": {
"mode": "text2video",
"text": "在这个快节奏的时代,我们往往忽略了身边的美好。停下脚步,你会发现,生活处处充满惊喜。无论是晨曦的第一缕阳光,还是夜晚的点点繁星,都是大自然赋予我们的宝贵财富。",
"video_id": "8b0d44bd-***82c52688530",
"voice_id": "genshin_vindi2",
"voice_language": "zh",
"voice_speed": 2
}
}'
返回响应
错误码,具体定义见错误码
错误信息
请求ID,系统生成,用于跟踪请求、排查问题
返回相关信息
显示子属性
隐藏子属性
任务ID
任务状态,说明:
· submitted:已提交
· processing:处理中
· succeed:成功
· failed:失败
任务创建时间,说明:Unix时间戳,单位ms
任务更新时间,说明:Unix时间戳,单位ms
{
"code": 0,
"message": "",
"request_id": "as-umdrs64i9t",
"data": {
"task_id": "67adba8e5b5ab6927a33478e",
"task_status": "submitted",
"created_at": 1739438734497,
"updated_at": 1739438734497
}
}
错误码
如果请求错误,请查看错误码说明。
