创建视频生成任务-文生视频
更新时间：2026-03-26
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
根据输入的文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID。
支持模型: K2.5-Turbo,K2.6,K3.0。
必选
type
string
任务类型。
固定值: text2video。
必选
model_parameters
object {9}
必选
显示子属性
隐藏子属性
multi_shot
boolean
是否生成多镜头视频，默认值：false。
- 当前参数为
true时，prompt参数无效。 - 当前参数为
false时，shot_type参数及multi_prompt参数无效。
可选
shot_type
string
分镜方式
customize：自定义配置intelligence：智能生成
当multi_shot参数为true时，当前参数必填。
可选
prompt
string
正向提示词，用于描述希望生成的视频内容。
字符⻓度不能超过 2500 个字符。
必选
negative_prompt
string
反向提示词，用于描述不希望生成的视频内容。
字符⻓度不能超过 2500 个字符。
可选
multi_prompt
array
各分镜提示词，可包含正向描述和负向描述
- 最多支持6个分镜，最小支持1个分镜
- 每个分镜相关内容的最大长度不超过512字符
- 每个分镜的时长大于1秒小于当前任务的总时长
- 所有分镜的时长之和等于当前任务的总时长
注：当multi-shot参数为true且shot-type参数为customize时，当前参数不得为空
可选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
index
integer
分镜序号
必选
prompt
string
该分镜的提示词内容。最大长度不超过 512 个字符。
必选
duration
string
该分镜的时长，单位为秒（s）。
必选
sound
string
是否生成音效。默认值：off。
on：同步生成与画面内容匹配的音效/环境声。off：仅生成视频画面，不包含音频。
注：本参数仅在K2.6及后续版本模型中生效。
可选
mode
string
视频生成模式。默认值：std。
std（标准模式）：适合日常使用，性价比高，生成720P视频。pro（专业模式）：适合对画质有较高要求的场景，生成视频质量更佳，生成1080P视频。
注：不同模型版本支持的模式范围有所差异，请参见能力地图。
可选
aspect_ratio
string
画面比例。
指定生成视频的宽高比。
支持：16:9（横屏）、9:16（竖屏）、1:1（方形）。
可选
duration
string
视频时长。
指定生成视频的时长，单位为秒（s）。
枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15。
注：不同模型版本支持的模式范围有所差异，请参见能力地图。
可选
请求结构
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": "模糊，低质量，黑白，变形，噪点",
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off"
}
}示例代码
基础调用
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": "模糊，低质量，黑白，变形，噪点",
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "5",
"sound": "off"
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
code
integer
错误码。
必选
message
string
错误信息。
必选
request_id
string
请求ID。
必选
data
object {5}
返回数据体，包含任务相关信息。
必选
显示子属性
隐藏子属性
task_id
string
任务ID。
必选
task_status
string
任务状态。
submitted：已提交processing：处理中succeed：成功failed：失败
必选
created_at
integer
任务创建时间，Unix 时间戳（毫秒）。
必选
updated_at
integer
任务更新时间，Unix 时间戳（毫秒）。
必选
task_info
object
任务详细信息。
必选
显示子属性
隐藏子属性
成功响应
{
"code": 0,
"message": "",
"request_id": "as-f3qdvqpyfk",
"data": {
"task_id": "6981b171ddc501bca6a099ec",
"task_status": "submitted",
"created_at": 1770107249000,
"updated_at": 1770107249000,
"task_info": {}
}
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_generation_internal_error | video generation service internal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_generation_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章