创建视频生成任务-文生视频
根据输入的文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
模型ID。
支持模型: K1,K1.6,K2.0,K2.1-Master,K2.5-Turbo,K2.6。
任务类型。
固定值: text2video。
显示子属性
隐藏子属性
正向提示词，用于描述希望生成的视频内容。
字符⻓度不能超过 2500 个字符。
反向提示词，用于描述不希望生成的视频内容。
字符⻓度不能超过 2500 个字符。
提示词相关性系数。取值范围：[0, 1] 默认值：0.5
值越高，生成内容越严格遵循提示词，创意自由度相应降低；
值越低，模型发挥空间越大，结果更具创造性但可能偏离提示。
视频生成模式。默认值：std。
std（标准模式）：适合日常使用，性价比高。pro（专业模式）：适合对画质有较高要求的场景，生成视频质量更佳。
注：不同模型版本支持的模式范围有所差异，请参见能力地图。
是否生成音效。默认值：off。
on：同步生成与画面内容匹配的音效/环境声。off：仅生成视频画面，不包含音频。 注：本参数仅在kling-v2-6及后续版本模型中生效。
控制摄像机运动的参数。
注：不同模型版本、视频模式支持范围不同，请参见能力地图。
显示子属性
隐藏子属性
运镜控制类型。默认使用simple模式，支持自定义运镜参数；其他模式为固定运镜，无需额外配置。
simple（简单运镜）：启用基础运镜模式，需在 config 参数中指定其中一种具体运动方式（如推拉、平移、旋转等）配置自定义运镜。down_back（下移拉远）：镜头垂直下压同时向后拉远，营造空间纵深感；固定轨迹，无需填写config参数。forward_up（推进上仰）：镜头向前推进并同步上仰，增强画面张力；固定轨迹，无需填写config参数。right_turn_forward（右旋推进）：镜头先向右水平旋转，随后向前推进；固定轨迹，无需填写config参数。left_turn_forward（左旋推进）：镜头先向左水平旋转，随后向前推进；固定轨迹，无需填写config参数。
用于指定摄像机在单一维度上的运动（推/拉、左/右移、上/下移、左/右旋转、俯/仰、变焦）。
仅当运镜类型为simple时需填写，每次仅启用一种基础运镜（六个参数中仅可设置一个非零值）。
显示子属性
隐藏子属性
水平运镜。
控制摄像机沿水平方向（x轴）的平移量。取值范围：[-10, 10]。负值表示向左平移，正值表示向右平移。
垂直运镜。
控制摄像机沿垂直方向（y轴）的平移量。取值范围：[-10, 10]。负值表示向下平移，正值表示向上平移。
水平摇镜。
控制摄像机绕垂直轴（y轴）的水平旋转量。取值范围：[-10, 10]。负值表示向左旋转，正值表示向右旋转。
垂直摇镜。
控制摄像机绕水平横轴（x轴）的俯仰旋转量。取值范围：[-10, 10]。负值表示向下俯仰（低头），正值表示向上仰起（抬头）。
旋转运镜。
控制摄像机绕镜头光轴（z轴）的滚动量。取值范围：[-10, 10]。负值表示逆时针滚动，正值表示顺时针滚动。
变焦。
控制摄像机焦距变化，影响画面视野范围。取值范围：[-10, 10]。负值表示拉近（视野变窄），正值表示拉远（视野变宽）。
画面比例。
指定生成视频的宽高比。
支持：16:9（横屏）、9:16（竖屏）、1:1（方形）。
视频时长。
指定生成视频的时长，单位为秒（s）。
枚举值：5、10。
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": "text2video",
"model_parameters": {
"prompt": "赛博朋克风格的街道，霓虹灯闪烁，雨中漫步的机器人，高分辨率，电影光效",
"negative_prompt": "模糊，低质量，黑白，变形，噪点",
"cfg_scale": 0.7,
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 0,
"vertical": 0,
"pan": 0,
"tilt": 0,
"roll": 0,
"zoom": 5
}
}
}
}示例代码
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": "text2video",
"model_parameters": {
"prompt": "赛博朋克风格的街道，霓虹灯闪烁，雨中漫步的机器人，高分辨率，电影光效",
"negative_prompt": "模糊，低质量，黑白，变形，噪点",
"cfg_scale": 0.7,
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off",
"camera_control": {
"type": "simple",
"config": {
"horizontal": 0,
"vertical": 0,
"pan": 0,
"tilt": 0,
"roll": 0,
"zoom": 5
}
}
}
}'返回响应
错误码。
错误信息。
请求ID。
返回数据体，包含任务相关信息。
显示子属性
隐藏子属性
任务ID。
任务状态。
submitted：已提交processing：处理中succeed：成功failed：失败
任务创建时间，Unix 时间戳（毫秒）。
任务更新时间，Unix 时间戳（毫秒）。
任务详细信息。
显示子属性
隐藏子属性
{
"code": 0,
"message": "",
"request_id": "as-f3qdvqpyfk",
"data": {
"task_id": "6981b171ddc501bca6a099ec",
"task_status": "submitted",
"created_at": 1770107249000,
"updated_at": 1770107249000,
"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 |