创建视频生成任务-对口型
创建对口型视频生成任务，基于创建视频生成任务-人脸识别返回的 session_id 和 face_id，指定音频与人脸完成对口型视频生成。
本接口为异步接口，创建成功后返回 task_id，需调用查询视频生成任务状态接口获取最终结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
模型名称。
固定值：K-Advanced-Lip-Sync。
任务类型。
固定值：advanced-lipsync。
支持模型范围：K-Advanced-Lip-Sync。
对口型模型专用参数。
显示子属性
隐藏子属性
会话 ID，基于对口型人脸识别接口生成。
指定人脸对口型。
包括人脸 ID、口型参考等内容。
暂时仅支持指定单人对口型。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
人脸 ID。
由人脸识别接口返回。
音频文件。
默认值：空。
支持传入音频 Base64 编码或音频 URL（确保可访问）。
格式支持：.mp3 / .wav / .m4a，文件大小不超过 5MB，格式不匹配或文件过大会返回错误码等信息。
仅支持使用时长不短于 2 秒且不长于 60 秒的音频。
注：系统会校验音频内容，如有问题会返回错误码等信息。
音频裁剪起点时间。
以原始音频开始时间为准，开始时间为 0 分 0 秒，单位 ms。
起点之前的音频会被裁剪，裁剪后音频不得短于 2 秒。
音频裁剪终点时间。
以原始音频开始时间为准，开始时间为 0 分 0 秒，单位 ms。
终点之后的音频会被裁剪，裁剪后音频不得短于 2 秒；终点时间不得晚于原始音频总时长。
裁剪后音频插入时间。
以视频开始时间为准，视频开始时间为 0 分 0 秒，单位 ms。
插入音频的时间范围与该人脸可对口型时间区间至少重合 2 秒时长；插入音频的开始时间不得早于视频开始时间，结束时间不得晚于视频结束时间。
音频音量大小；值越大，音量越大。
默认值：1。
取值范围：[0, 2]。
原始视频音量大小；值越大，音量越大。
默认值：1。
取值范围：[0, 2]。
原视频无声时，当前参数无效果。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "K-Advanced-Lip-Sync",
"type": "advanced-lipsync",
"model_parameters": {
"session_id": "905608****52138524",
"face_choose": [
{
"face_id": "-1",
"sound_file": "xxx",
"sound_start_time": 0,
"sound_end_time": 4000,
"sound_insert_time": 0,
"sound_volume": 1,
"original_audio_volume": 0.5
}
]
}
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/qianfan-video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-********skoq/5fe******c51a82507075435269f681a' \
--data '{
"model": "K-Advanced-Lip-Sync",
"type": "advanced-lipsync",
"model_parameters": {
"session_id": "905608****52138524",
"face_choose": [
{
"face_id": "-1",
"sound_file": "https://p1-*****.com/kcdn/cdn-kcdn112452/****-qa-test/go-to-world.mp3",
"sound_start_time": 0,
"sound_end_time": 4000,
"sound_insert_time": 0,
"sound_volume": 1,
"original_audio_volume": 0.5
}
]
}
}'返回响应
错误码，具体定义见错误码文档。成功时固定返回 0。
错误信息。
请求 ID，系统生成，用于跟踪请求、排查问题。
返回数据体，包含任务相关信息。
显示子属性
隐藏子属性
任务ID。
任务状态。
submitted：已提交processing：处理中succeed：成功failed：失败
任务创建时间，Unix 时间戳（毫秒）。
任务更新时间，Unix 时间戳（毫秒）。
预留参数。
显示子属性
隐藏子属性
{
"code": 0,
"message": "",
"request_id": "as-meg7zkx90w",
"data": {
"task_id": "6a54d3a9b8a1abbf0e85f853",
"task_status": "submitted",
"created_at": 1783944105000,
"updated_at": 1783944105000,
"task_info": {}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 0 | 请求成功 | - | - |
| 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
| 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
| 1201 | 请求参数非法 | 参数非法，如key写错或value非法 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1202 | 请求参数非法 | 请求的method无效 | 查看接口文档，使用正确的request method |
| 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
| 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
| 5000 | 内部错误 | 服务器内部错误 | 稍后重试，或联系客服 |
| 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | 稍后重试，或联系客服 |
| 5002 | 内部错误 | 服务器内部超时，通常是发生积压 | 稍后重试，或联系客服 |
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_genration_interal_error | video generation service interal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章