创建视频生成任务-对口型
创建对口型视频生成任务,支持文本生成视频和音频生成视频两种模式。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
模型名称。
固定值:K-Lip-Sync。
任务类型。
固定值:lipsync。
模型参数配置。
显示子属性
隐藏子属性
输入参数对象,用于指定视频、口型对应内容等。
显示子属性
隐藏子属性
原始视频下载链接。
默认值:空
与 video_id 参数必须二选一,不可同时为空。
格式支持:.mp4 / .mov。
文件大小 ≤ 100MB;时长 [2s, 10s];分辨率支持 720p/1080p;长宽边长范围 720px~1920px。
注:系统将对视频内容进行合规校验。
生成视频模式。
枚举值:
● text2video:文本生成视频。需配置 text、voice_id 参数。
● audio2video:音频生成视频。需配置 audio_type 参数。
对口型文本内容。
当 mode 为 text2video 时必填。
长度限制:最大 120 字符。
注:系统将对文本内容进行合规校验。
音色 ID。
当 mode 为 text2video 时必填。
请参见音色列表获取音色 ID、音色效果、音色语种对应关系。音色试听需遵循文件命名规范:音色名称#音色ID#音色语种
音色语种。
默认值:zh
支持:zh(中文)、en(英文)。
当 mode 为 text2video 时必填,且需与 voice_id 对应,参见音色列表。
语速。有效范围:[0.8, 2.0](精度保留一位小数,超出部分自动四舍五入)。
当 mode 为 text2video 时必填
音频数据传输方式。
当 mode 为 audio2video 时必填。
枚举值:
● file:上传文件模式(audio_file参数必填)。
● url:提供下载链接模式(audio_url参数必填)。
音频文件本地路径,Base64编码。
当 audio_type 为 file 时必填。
格式支持:.mp3 / .wav / .m4a / .aac。
文件大小:≤ 5MB。
注:系统将对音频内容进行合规校验。
音频文件下载链接。
当 audio_type 为 url 时必填。
格式支持:.mp3 / .wav / .m4a / .aac。
文件大小:≤ 5MB。
注:系统将对音频内容进行合规校验。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "K-Lip-Sync",
"type": "lipsync",
"model_parameters": {
"input": {
"mode": "text2video",
"video_url": "https://testdde.bj.bcebos.com/video.mp4",
"text": "你好,这是百度千帆数字人口型生成测试。",
"voice_id": "Sample_Voice_ID",
"voice_language": "zh",
"voice_speed": 1
}
}
}
示例代码
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "K-Lip-Sync",
"type": "lipsync",
"model_parameters": {
"input": {
"mode": "text2video",
"video_url": "https://testdde.bj.bcebos.com/video.mp4",
"text": "你好,这是百度千帆数字人口型生成测试。",
"voice_id": "Sample_Voice_ID",
"voice_language": "zh",
"voice_speed": 1
}
}
}'
返回响应
错误码。
错误信息。
请求ID。
返回数据体,包含任务相关信息。
显示子属性
隐藏子属性
任务ID。
任务状态。
submitted:已提交processing:处理中succeed:成功failed:失败
任务创建时间,Unix 时间戳(毫秒)。
任务更新时间,Unix 时间戳(毫秒)。
任务详细信息。
显示子属性
隐藏子属性
{
"code": 0,
"message": "",
"request_id": "as-degf2spgws",
"data": {
"task_id": "6981eb4fd9d1b2f80efefc8c",
"task_status": "submitted",
"created_at": 1770122063000,
"updated_at": 1770122063000,
"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 |
