创建视频生成任务
创建视频生成任务，根据输入的文本提示词、图片、音频或视频生成视频，返回 task_id 用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
模型名称
枚举值：S2.0、S2.0-Fast、S2.0-Mini
输入给模型，生成视频的信息，支持文本、图片、音频、视频。支持以下几种组合：
文本
文本（可选）+ 图片
文本（可选）+ 视频
文本（可选）+ 图片 + 音频
文本（可选）+ 图片 + 视频
文本（可选）+ 视频 + 音频
文本（可选）+ 图片 + 视频 + 音频
显示子属性
隐藏子属性
显示子属性
隐藏子属性
首帧：需要传入 1 个 image_url 对象，字段 role 为 first_frame 或不填
首尾帧：需要传入 2 个 image_url 对象，且字段 role 必填 first_frame、last_frame
多图生视频：必填，每张参考图对应的字段 role 均为：reference_image
视频：reference_video
音频：reference_audio
输入给模型的文本提示词，描述期望生成的视频正向提示词，用于描述希望生成的视频内容，字符长度不能超过 2500 个字符。
内容类型。可选值: text、image_url、video_url、audio_url
输入给模型的音频对象
显示子属性
隐藏子属性
数据格式：支持 HTTP URL 或 Base64 编码字符串。
格式约束：data:audio/<音频格式>;base64,<Base64编码>，注意 <音频格式> 需小写，如 data:audio/wav;base64,{base64_audio}
格式：wav、mp3
时长：单个音频时长 [2, 15]s，最多传入 3 段参考音频，所有音频总时长 < 15s。
大小：单个音频不< 15MB，总文件 < 64MB
输入给模型的图片对象
显示子属性
隐藏子属性
数据格式：支持 HTTP URL 或 Base64 编码字符串。
格式约束：data:image/<图片格式>;base64,<Base64编码>，注意 <图片格式> 需小写，如 data:image/png;base64,{base64_image}。
图片格式：jpeg、png、webp、bmp、tiff、gif、heic、heif。
宽高比（宽/高）：[0.4, 2.5]
宽高长度（px）：[300, 6000]
大小：单张 < 30MB，总共不超 64MB。
图片数量：
图生视频-首帧：1 张
图生视频-首尾帧：2 张
多图生视频：1~9 张
输入给模型的视频对象
显示子属性
隐藏子属性
数据格式：支持 HTTP URL，视频编码 H.264/AVC、H.265/HEVC 和音频编码 AAC、MP3 的 mov 与 MP4。
分辨率：480p、720p、1080p、4k
时长：单个视频时长 [2, 15]s，最多传入 3 个参考视频，所有视频总时长 < 15s。
尺寸：
宽高比（宽/高）：[0.4, 2.5]
宽高长度（px）：[300, 6000]
总像素数：[640×640=409600, 3326×2494=8295044]，即宽和高的乘积符合 [409600, 8295044] 的区间要求。
大小：单个视频不超过 200MB。
帧率（FPS）：[24, 60]
false：不返回生成视频的尾帧图像true：返回生成视频的尾帧图像，可用于连贯视频生产工作流
任务超时阈值
true：模型输出的视频包含同步音频。false：模型输出的视频为无声视频。
显示子属性
隐藏子属性
type 参数：web_search，联网搜索工具可选
都支持480p720p
仅部分支持1080p4k
枚举值：16:9、4:3、1:1、3:4、9:16、21:9
枚举值：4-15秒
false：生成视频不含水印。true：生成视频右下角会展示 AI 生成水印
POST /beta/video/generations/qianfan-video/fireseries HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "S2.0",
"content": [
{
"type": "text",
"text": "全程使用【视频 1】的第一视角构图，全程使用【音频 1】作为背景音乐。第一人称视角果茶宣传广告..."
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/assets/picture1.jpg"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/assets/video1.mp4"
},
"role": "reference_video"
}
],
"return_last_frame": true,
"generate_audio": true,
"ratio": "16:9",
"duration": 11,
"resolution": "720p",
"watermark": false
}示例代码
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video/fireseries" \
-H "Authorization: Bearer bce-v3/ALTAK-*************eb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "S2.0",
"content": [
{
"type": "text",
"text": "全程使用【视频 1】的第一视角构图，全程使用【音频 1】作为背景音乐。第一人称视角果茶宣传广告..."
},
{
"type": "image_url",
"image_url": {
"url": "https://example.com/assets/picture1.jpg"
},
"role": "reference_image"
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/assets/video1.mp4"
},
"role": "reference_video"
}
],
"return_last_frame": true,
"generate_audio": true,
"ratio": "16:9",
"duration": 11,
"resolution": "720p",
"watermark": false
}'返回响应
任务 ID（task_id），用于后续查询任务状态和结果。
本次任务使用的模型名称。
任务状态。可选值: queued（排队中）、running（任务运行中）、succeeded（任务成功）、failed（任务失败）、cancelled（已取消）、expired（任务超时）
任务内容对象，任务完成后包含生成结果信息。
显示子属性
隐藏子属性
暂无参数
Token 使用统计信息。
显示子属性
隐藏子属性
补全消耗的 token 数。
总消耗的 token 数。
任务创建时间（Unix 时间戳，单位：秒）。
任务最后更新时间（Unix 时间戳，单位：秒）。
服务等级。
任务超时阈值（秒）。
{
"id": "cgt-20260707000000-xxxx",
"model": "S2.0",
"status": "queued",
"content": {},
"usage": {
"completion_tokens": 0,
"total_tokens": 0
},
"created_at": 1779348818,
"updated_at": 1779348818,
"service_tier": "default",
"execution_expires_after": 172800
}评价此篇文章