对口型

请求地址


POST https://api.vidu.cn/ent/v2/lip-sync

请求头

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将{token}替换为提供给您的token

请求体

参数名称	类型	必填	参数描述
video_url	String	是	原视频 URL（需要确保可访问）模型将以此参数中传入的视频为画面来匹配口型的视频注1：视频仅支持格式：mp4、mov、avi；注2：支持1 - 600秒，建议时长在10秒到120秒；注3：文件大小不超过5G；注4 ：视频本身要求编码格式为 H.264 格式，若不是，可通过下述方法转换。请参见编码格式转换；注5：视频内容免涉肖像权，否则会被下架或销毁注6：对于视频素材的规范性要求： * 人脸画面：要求真人出镜（如果是卡通人物，需要人物五官和真人比例相近），画面中的人脸说话时，建议正对镜头，水平转动不超过45度，俯仰不超过15度；人脸尽量不遮挡，面部光线稳定； * 说话音频：对音频无限制。
audio_url	String	可选	音频文件url 对口型视频中使用的文字、音色，以音频文件的内容为准注1：支持格式：wav、mp3、wma、m4a、aac、ogg 注2 ：音频时长大于1s，小于600s 注3：大小要求：不超过100MB
text	String	可选	对口型视频生成时使用的文本内容注1：文字内容不少于4个字符，不超过2000字符（2-1000个汉字或4-2000个英文）。注2：与audio_url同时有值时，以audio_url中的内容生成
speed	Float	可选	语速，默认为1.0 * 1.0为正常语速，范围[0.5-1.5]，值为0.5时播报语速最慢，值为1.5时播报语速最快； * 仅文字生成时生效
character_id	String	可选	音色ID * 系统提供多种音色可供选择，具体音色效果、音色ID、音色语种对应关系见文档：音色列表； * 仅文字生成时生效
volume int	Int	可选	音量大小 * 范围 0 - 10，默认为0，代表正常音量，值越大音量越高 * 男声1 - 20、女声1 - 23 间的音色不支持音量调节，具体见文档：音色列表 * 仅文字生成时生效
language	String	可选	语种 * 多语种音色在生成时必须选择对应语种； * 可选语种见文档：音色列表。 * 仅文字生成时生效
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的”status”包括以下状态： * processing 任务处理中 * success 任务完成（如发送失败，回调3次） * failed 任务失败（如发送失败，回调3次）

音频驱动调用示例


curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
    "video_url": "your_video_url",
    "audio_url": "your_audio_url"
}' https://api.vidu.cn/ent/v2/lip-sync

文本驱动调用示例


curl -X POST -H "Authorization: Token {your_api_key}" -H "Content-Type: application/json" -d '
{
    "video_url":"your_video_url",
    "text":"你好，欢迎使用vidu开放平台",
    "character_id":"male_1"
}' https://api.vidu.cn/ent/v2/lip-sync

响应体

创建对口型任务时，不会返回积分使用情况，请在任务查询接口中查看消耗的积分。

参数名称	类型	描述
task_id	String	Vidu生成的任务ID
state	String	处理状态可选值： * created 创建成功 * queueing 任务排队中 * processing 任务处理中 * success 任务成功 * failed 任务失败
payload	String	本次调用时传入的透传参数
created_at	String	任务创建时间


{
  "task_id": "your_task_id_here",
  "state": "created",
  "payload":"",
  "created_at": "2025-01-01T15:41:31.968916Z"
}