创建视频生成任务-文生视频
更新时间：2026-07-14
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
根据输入的文本提示词生成视频，支持多镜头分镜，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型ID。
固定值：k3.0-turbo。
注：模型 ID 区分大小写，请严格按上述写法填写。
必选
type
string
任务类型。
固定值: text2video。
必选
model_parameters
object {3}
必选
显示子属性
隐藏子属性
prompt
string
文本提示词，可包含正向描述和负向描述。
- 内容长度不能超过 3072 个字符，建议内容长度不超过 2500 个字符。
- 可将提示词模板化来满足不同的视频生成需求。
- 多镜头视频通过在本字段内嵌固定格式实现，格式为“镜头n,m,words; 镜头n,m,words;”，用半角符号分隔，其中：
n：分镜序号；最多支持 6 个分镜，最少支持 1 个分镜。m：分镜时长；每个分镜时长不小于 1，所有分镜时长之和等于当前所生成视频总时长。words：分镜提示词；最大长度 512。
必选
settings
object {3}
输出配置相关参数，如清晰度、时长等。
可选
显示子属性
隐藏子属性
resolution
string
生成视频的清晰度。
720p：输出清晰度为 720P 的视频。1080p：输出清晰度为 1080P 的视频。
可选
aspect_ratio
string
生成视频的画面纵横比（宽:高）。
支持：16:9、9:16、1:1。默认值：16:9。
可选
duration
integer
生成视频时长，单位为秒（s），默认值：5。
枚举值：3，4，5，6，7，8，9，10，11，12，13，14，15。
可选
options
object {1}
通用配置，如回调地址、是否含水印等。
可选
显示子属性
隐藏子属性
watermark_info
object {1}
是否同时生成含水印的结果。
- 通过
enabled参数定义，格式："watermark_info": { "enabled": boolean }。 true为生成，false为不生成。- 暂不支持自定义水印。
可选
显示子属性
隐藏子属性
enabled
boolean
是否生成含水印的结果。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "k3.0-turbo",
"type": "text2video",
"model_parameters": {
"prompt": "赛博朋克风格的街道，霓虹灯闪烁，雨中漫步的机器人，高分辨率，电影光效",
"settings": {
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5
}
}
}示例代码
请求示例
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video" \
-H "Authorization: Bearer bce-v3/ALTAK-******/****" \
-H "Content-Type: application/json" \
-d '{
"model": "k3.0-turbo",
"type": "text2video",
"model_parameters": {
"prompt": "赛博朋克风格的街道，霓虹灯闪烁，雨中漫步的机器人，高分辨率，电影光效",
"settings": {
"resolution": "720p",
"aspect_ratio": "16:9",
"duration": 5
}
}
}'返回响应
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-a003hh3512",
"data": {
"task_id": "6a54a8575ece998ead9b5670",
"task_status": "submitted",
"created_at": 1783933015000,
"updated_at": 1783933015000,
"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 |
评价此篇文章