创建视频生成任务-动作控制
本接口支持根据参考图像和参考视频,利用提示词生成具有特定动作和风格的高质量视频。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
模型名称。
固定值:K2.6
任务类型。
固定值:motion-control
模型参数配置。
显示子属性
隐藏子属性
文本提示词。
默认值:空
用于增加画面元素、控制运镜效果等,包含正向描述与负向描述。
长度限制:最大 2500 字符。
参考图像(角色源)。
生成视频中的人物、背景等元素均以此图为准。
数据格式:支持 HTTP URL 或 Base64 编码字符串(无前缀),如:data:image/png;base64。
● 格式:.jpg / .jpeg / .png
● 文件大小:≤ 10MB
● 分辨率:宽高范围 [300px, 65536px]
● 宽高比:1:2.5 ~ 2.5:1
视频内容需满足:
● 主体完整:需露出清晰的上半身或全身肢体及头部,避免遮挡。
● 比例适配:人物比例尽量与参考动作视频一致(避免“全身动作驱动半身人物”)。
● 姿态正常:避免倒立、平卧等极端朝向。
● 角色类型:支持真实/风格化人物、类人动物。
动作参考视频下载链接。
生成视频中的人物动作将以此视频为准。
● 格式:.mp4 / .mov
● 文件大小:≤ 100MB
● 分辨率:长宽范围 [340px, 3850px]
时长下限:≥ 3秒,动态上限(取决于 character_orientation):
当朝向设为 video 时:≤ 30秒。
当朝向设为 image 时:≤ 10秒。
内容需满足:
● 单人一镜到底:建议单人(多人取最大占比),必须一镜到底,严禁切镜/运镜。
● 动作平稳:若动作过快/难度过高,模型可能无法提取足够时长(需至少 3s 连续有效动作),导致生成片段短于预期且积分不退。
注:系统会校验视频内容。
是否保留视频原声。
默认值:yes
枚举值:
● yes:保留原声。
● no:不保留原声。
生成视频中人物的朝向控制。
枚举值:
● image:保持参考图片中的人物朝向(此时视频时长限制 ≤ 10s)。
● video:跟随参考视频中的人物朝向(此时视频时长限制 ≤ 30s)。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "K2.6",
"type": "motion-control",
"model_parameters": {
"image_url": "https://example.com/image.jpg",
"video_url": "https://example.com/video.jpg",
"prompt": "高清,电影质感,细节丰富",
"character_orientation": "video",
"mode": "pro",
"keep_original_sound": "yes"
}
}
示例代码
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": "K2.6",
"type": "motion-control",
"model_parameters": {
"image_url": "https://example.com/image.jpg",
"video_url": "https://example.com/video.jpg",
"prompt": "高清,电影质感,细节丰富",
"character_orientation": "video",
"mode": "pro",
"keep_original_sound": "yes"
}
}'
返回响应
错误码。
错误信息。
请求ID。
返回数据体,包含任务相关信息。
显示子属性
隐藏子属性
任务ID。
任务状态。
submitted:已提交processing:处理中succeed:成功failed:失败
任务创建时间,Unix 时间戳(毫秒)。
任务更新时间,Unix 时间戳(毫秒)。
任务详细信息。
显示子属性
隐藏子属性
{
"code": 0,
"message": "",
"request_id": "as-degf2spgws",
"data": {
"task_id": "6981****9d1b2f80efefc8c",
"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 |
