创建文生视频任务
调用本接口，创建一个文生视频任务。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
用于生成视频的模型，目前已支持的模型：
· kling-v1-6
· kling-v1
正向文本提示词，最大2500字符
负向文本提示词，最大2500字符
生成视频的自由度，说明：
（1）值越大，模型自由度越小，与用户输入的提示词相关性越强
（2）取值范围：[0, 1]，默认0.5
生成视频的模式，说明：
（1）可选值：
· std：标准模式（标准），基础模式，性价比高
· pro：专家模式（高品质），高表现模式，生成视频质量更佳
（2）不同模型版本、视频模式支持范围不同，详见能力地图
控制摄像机运动的协议，说明：
（1）未指定，模型将根据输入的文本/图片进行智能匹配
（2）不同模型版本、视频模式支持范围不同，详见能力地图
显示子属性
隐藏子属性
预定义的运镜类型，说明：
· simple：简单运镜，此类型下可在"config"中六选一进行运镜
· down_back：镜头下压并后退 ➡️ 下移拉远，此类型下config参数无需填写
· forward_up：镜头前进并上仰 ➡️ 推进上移，此类型下config参数无需填写
· right_turn_forward：先右旋转后前进 ➡️ 右旋推进，此类型下config参数无需填写
· left_turn_forward：先左旋并前进 ➡️ 左旋推进，此类型下config参数无需填写
包含六个字段，用于指定摄像机在不同方向上的运动或变化，说明：
（1）当运镜类型指定simple时必填，指定其他类型时不填
（2）以下参数6选1，即只能有一个参数不为0，其余参数为0
显示子属性
隐藏子属性
水平运镜，控制摄像机在水平方向上的移动量（沿x轴平移），取值范围：[-10, 10]，负值表示向左平移，正值表示向右平移
垂直运镜，控制摄像机在垂直方向上的移动量（沿y轴平移），取值范围：[-10, 10]，负值表示向下平移，正值表示向上平移
水平摇镜，控制摄像机在水平面上的旋转量（绕y轴旋转），取值范围：[-10, 10]，负值表示绕y轴向左旋转，正值表示绕y轴向右旋转
垂直摇镜，控制摄像机在垂直面上的旋转量（沿x轴旋转），取值范围：[-10, 10]，负值表示绕x轴向下旋转，正值表示绕x轴向上旋转
旋转运镜，控制摄像机的滚动量（绕z轴旋转），取值范围：[-10, 10]，负值表示绕z轴逆时针旋转，正值表示绕z轴顺时针旋转
变焦，控制摄像机的焦距变化，影响视野的远近，取值范围：[-10, 10]，负值表示焦距变长、视野范围变小，正值表示焦距变短、视野范围变大
生成视频的画面纵横比，宽:高，可选值：
· 16:9
· 9:16
· 1:1
生成视频时长，单位s，可选值：5 或 10
POST /beta/video/generations/kling/text2video HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model_name": "kling-v1-6",
"mode": "std",
"duration": "5",
"prompt": "下班",
"negative_prompt": "",
"aspect_ratio":"16:9",
"callback_url":""
}示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/kling/text2video' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model_name": "kling-v1-6",
"mode": "std",
"duration": "5",
"prompt": "下班",
"negative_prompt": "",
"aspect_ratio":"16:9",
"callback_url":""
}'返回响应
错误码，具体定义见错误码
错误信息
请求ID，系统生成，用于跟踪请求、排查问题
返回相关信息
显示子属性
隐藏子属性
任务ID
任务状态，说明：
· submitted：已提交
· processing：处理中
· succeed：成功
· failed：失败
任务创建时间，说明：Unix时间戳，单位ms
任务更新时间，说明：Unix时间戳，单位ms
{
"code": 0,
"message": "",
"request_id": "as-umdrs64i9t",
"data": {
"task_id": "67adba8e5b5ab6927a33478e",
"task_status": "submitted",
"created_at": 1739438734497,
"updated_at": 1739438734497
}
}错误码
如果请求错误，服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码，请查看模型错误码说明。