创建视频生成任务-图生视频
根据输入的一张首帧图像和文本提示词生成视频，返回task_id用于后续查询结果。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
用于生成视频的模型。可选值如下：
· VQ4：最新模型，支持音画同出、自动切镜。
· VQ3-Pro：支持音画同步及分镜生成，画质效果最佳。
· VQ3-Turbo：支持音画同步及分镜生成，生成速度更快。
· VQ2-Turbo：生成速度快，综合效果优秀。
· VQ2-Pro：画面细节丰富，生成质量高。
任务类型，固定值：img2video。
模型参数配置。
显示子属性
隐藏子属性
首帧图像。
支持图片 URL（需公网可访问）或 Base64 编码。
- 数量限制：仅支持输入 1 张图片。
- 支持格式：png、jpeg、jpg、webp。
- 比例限制：图片宽高比需介于 1:4 至 4:1 之间。
图片文件不可超过 50 MB；Base64 解码后的字节长度需小于 10 MB。使用 Base64 时必须包含完整的内容类型前缀，例如：data:image/png;base64,{base64_encode}。
显示子属性
隐藏子属性
文本提示词，生成视频的文本描述。
字符长度不能超过 2000 个字符；
若使用 is_rec 推荐提示词参数，模型将忽略此参数所输入的提示词。
是否使用音视频直出能力，默认为 false
false：静音视频true：音画同步视频
该参数为true时，voice_id参数生效；
当model为VQ3和VQ4系列时，该参数默认值为true。
是否为生成的视频添加背景音乐，默认值：false。
true：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。false：关闭。不添加背景音乐。 生效限制：- 当
audio参数为true时，bgm参数不生效。 - 当使用
VQ3系列模型，以及VQ2系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，bgm参数不生效。 VQ4不支持该参数。
视频时长（秒）。
VQ4：默认为 5，可选范围：3 - 16 的任意整数VQ3-Pro、VQ3-Turbo：默认为 5，可选范围：1 - 16 的任意整数VQ2-Pro：默认为 5，可选范围：1 - 10 的任意整数VQ2-Turbo：默认为 5，可选：1 - 10 的任意整数
是否使用系统推荐提示词。默认值：false。
true：由系统自动生成 1 条提示词并作为视频生成依据。false：根据用户传入的prompt参数生成视频。- 计费说明：开启该功能后，每个任务将额外消耗 10 积分。
分辨率参数，默认值依据模型和视频时长而定：
VQ4：默认为 720p，可选：540p、720p、1080p、2K、4KVQ3-Pro、VQ3-Turbo：默认 720p，可选：540p、720p、1080pVQ2-Pro：默认为 720p，可选：540p、720p、1080pVQ2-Turbo：默认为 720p，可选：540p、720p、1080p
随机种子。
当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。
用户可传入非零整数值作为固定种子，以实现结果的可复现性。
是否添加水印。 · true：添加水印。 · false：不添加水印。 注：目前水印内容固定为“内容由 AI 生成”，默认不加。
水印位置，表示水印出现在视频中的位置，可选项为：
· 1：左上角
· 2：右上角
· 3：右下角（默认）
· 4：左下角
水印内容，此处为图片 URL，不传时使用默认水印：内容由 AI 生成。
元数据标识，JSON 格式字符串，透传字段；该参数为空时，默认使用 vidu 生成的元数据标识。
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "VQ2-Pro",
"type": "img2video",
"model_parameters": {
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果"
}
}示例代码
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video"
-H "Authorization: Bearer <API_KEY>"
-H "Content-Type: application/json"
-d '{
"model": "VQ4",
"type": "img2video",
"model_parameters": {
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "宇航员挥手，镜头缓缓上移",
"duration": 5,
"resolution": "1080p",
"seed": 12345
}
}'返回响应
日志ID，用于问题排查。
任务ID，用于后续查询生成结果。
任务状态，标识当前任务所处阶段。
created创建成功queueing任务排队中processing任务处理中success任务成功failed任务失败
使用的模型名称。
首帧图像。
显示子属性
隐藏子属性
输入的提示词内容。
视频时长 (秒)。
使用的随机种子。
生成的视频分辨率。
设置的运动幅度。
任务创建的时间，格式为时间戳字符串（毫秒级）。
仅请求参数 bgm 为 true 时回显
{
"log_id": "as-tbatpi9zxz",
"task_id": "697b217128a819d37fce4c4b",
"status": "created",
"model": "VQ2-Pro",
"images": [
"https://example.com/test_image_1.jpg"
],
"prompt": "一条缓缓流淌的河流，电影级光影效果",
"duration": 5,
"seed": 12345,
"resolution": "720p",
"movement_amplitude": "medium",
"created_at": "1769677169000"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| 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 |
评价此篇文章