视频生成 API

概述

Vidu 视频生成 API 支持多种视频生成模式，包括文生视频、图生视频、参考图生视频和起始-结束帧生视频。基于 Vidu 的先进 AI 模型，能够生成高质量的视频内容。

接口信息

请求地址： POST /v1/tasks/generations

内容类型： application/json

认证方式： Bearer Token

请求头示例：

模型能力

支持的模型

模型名称	模型 ID	支持功能	特点
Vidu Q1	`vidu/vidu-q1`	文生视频、图生视频、参考图生视频、起始-结束帧生视频	清晰画面、平滑过渡、稳定相机运动
Vidu 2.0	`vidu/vidu-2.0`	图生视频、参考图生视频、起始-结束帧生视频	快速生成速度，不支持文生视频
Vidu 1.5	`vidu/vidu-1.5`	文生视频、图生视频、参考图生视频、起始-结束帧生视频	大动态幅度

参数说明

基础参数

参数名	类型	必填	默认值	描述	限制
`model`	string	✅	-	模型 ID	见支持的模型列表
`prompt`	string	❌	-	文本提示词	≤1500字符，支持中英文

视频生成参数

参数名	类型	必填	默认值	描述	取值范围
`duration`	int	❌	见模型说明	视频时长（秒）	见分辨率与时长支持
`resolution`	string	❌	见模型说明	视频分辨率	`360p`, `720p`, `1080p`
`seed`	int	❌	随机	随机种子	-1 到 2^31-1
`movement_amplitude`	string	❌	auto	物体运动幅度	`auto`, `small`, `medium`, `large`
`bgm`	bool	❌	false	是否添加背景音乐	`true`, `false`
`payload`	string	❌	-	透传参数	≤1048576字符

图像相关参数

图生视频

参数名	类型	必填	默认值	说明
`images`	array	✅	-	图片数组（仅支持1张）

参考图生视频

参数名	类型	必填	默认值	说明
`images`	array	✅	-	参考图片数组（1-7张）
`reference`	bool	✅	-	参考生成标识
`aspect_ratio`	string	❌	16:9	视频宽高比

起始-结束帧生视频

参数名	类型	必填	默认值	说明
`images`	array	✅	-	起始和结束帧图片（必须2张，宽高比需接近）

样式参数（仅文生视频）

参数名	类型	必填	默认值	取值范围
`style`	string	❌	general	`general`, `anime`
`aspect_ratio`	string	❌	16:9	`16:9`, `9:16`, `1:1`

参数详细说明

模型功能支持

功能类型	vidu-q1	vidu-2.0	vidu-1.5
文生视频	✅	❌	✅
图生视频	✅	✅	✅
参考图生视频	✅	✅	✅
起始-结束帧生视频	✅	✅	✅

分辨率与时长支持

vidu-q1（文生视频、图生视频、参考图生视频、起始-结束帧生视频）

模型	时长	分辨率	说明
vidu-q1	5秒	1080p	固定参数

vidu-2.0（图生视频、参考图生视频、起始-结束帧生视频）

时长	可用分辨率	默认分辨率
4秒	360p, 720p	360p

vidu-1.5（文生视频、图生视频、参考图生视频、起始-结束帧生视频）

时长	可用分辨率	默认分辨率
4秒	360p, 720p, 1080p	360p
8秒	720p	720p

图片要求

项目	要求
格式	PNG、JPEG、JPG、WebP
大小	≤ 50MB
Base64 限制	解码后 ≤ 10MB
最小尺寸	128×128 像素
宽高比	1:4 到 4:1 之间
数量限制	图生视频：1张，参考图生视频：1-7张，起始-结束帧：2张
起始-结束帧特殊要求	两张图片宽高比必须接近（比值在0.8-1.25之间）
编码	Base64（`data:image/<format>;base64,<data>`）或 HTTP URL

请求示例

文生视频 (Text-to-Video)

基础文生视频

{
  "model": "vidu/vidu-q1",
  "prompt": "一只可爱的小猫在花园里追逐蝴蝶，阳光明媚，画面温馨"
}

带样式的文生视频

{
  "model": "vidu/vidu-1.5",
  "prompt": "一个机器人在未来城市中行走，科幻风格",
  "style": "general",
  "aspect_ratio": "16:9",
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "medium",
  "seed": 12345
}

动漫风格文生视频

{
  "model": "vidu/vidu-1.5",
  "prompt": "动漫少女在樱花树下跳舞",
  "style": "anime",
  "aspect_ratio": "9:16",
  "duration": 8,
  "resolution": "720p",
  "bgm": true
}

图生视频 (Image-to-Video)

基础图生视频（使用 URL）

{
  "model": "vidu/vidu-q1",
  "images": ["https://example.com/input.jpg"],
  "prompt": "让图片中的人物微笑并轻轻点头"
}

图生视频（使用 Base64）

{
  "model": "vidu/vidu-2.0",
  "images": ["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."],
  "prompt": "让场景动起来，添加微风效果",
  "duration": 4,
  "resolution": "720p",
  "movement_amplitude": "large"
}

无提示词图生视频

{
  "model": "vidu/vidu-1.5",
  "images": ["https://example.com/landscape.jpg"],
  "duration": 8,
  "resolution": "720p",
  "movement_amplitude": "auto"
}

参考图生视频 (Reference-to-Video)

单参考图生视频

{
  "model": "vidu/vidu-q1",
  "images": ["data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD..."],
  "reference": true,
  "prompt": "参考这个人物形象，在咖啡厅里微笑着喝咖啡"
}

多参考图生视频

{
  "model": "vidu/vidu-2.0",
  "images": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg",
    "https://example.com/ref3.jpg"
  ],
  "reference": true,
  "prompt": "基于这些参考图像生成一个连贯的视频场景",
  "duration": 4,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "seed": 54321
}

起始-结束帧生视频 (Start-End Frame-to-Video)

双帧生成视频

{
  "model": "vidu/vidu-q1",
  "images": [
    "https://example.com/start_frame.jpg",
    "https://example.com/end_frame.jpg"
  ],
  "prompt": "从起始状态平滑过渡到结束状态"
}

高分辨率双帧生成

{
  "model": "vidu/vidu-2.0",
  "images": [
    "https://example.com/start_frame.jpg",
    "https://example.com/end_frame.jpg"
  ],
  "prompt": "从起始状态平滑过渡到结束状态",
  "duration": 4,
  "resolution": "1080p",
  "movement_amplitude": "medium"
}

使用 Base64 的双帧生成

{
  "model": "vidu/vidu-1.5",
  "images": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUB..."
  ],
  "prompt": "物体从左边移动到右边，动作流畅自然",
  "duration": 8,
  "resolution": "720p",
  "bgm": true
}

概述#

接口信息#

模型能力#

支持的模型#

参数说明#

基础参数#

视频生成参数#

图像相关参数#

图生视频#

参考图生视频#

起始-结束帧生视频#

样式参数（仅文生视频）#

参数详细说明#

模型功能支持#

分辨率与时长支持#

vidu-q1（文生视频、图生视频、参考图生视频、起始-结束帧生视频）#

vidu-2.0（图生视频、参考图生视频、起始-结束帧生视频）#

vidu-1.5（文生视频、图生视频、参考图生视频、起始-结束帧生视频）#

图片要求#

请求示例#

文生视频 (Text-to-Video)#

基础文生视频#

带样式的文生视频#

动漫风格文生视频#

图生视频 (Image-to-Video)#

基础图生视频（使用 URL）#

图生视频（使用 Base64）#

无提示词图生视频#

参考图生视频 (Reference-to-Video)#

单参考图生视频#

多参考图生视频#

起始-结束帧生视频 (Start-End Frame-to-Video)#

双帧生成视频#

高分辨率双帧生成#

使用 Base64 的双帧生成#

概述

接口信息

模型能力

支持的模型

参数说明

基础参数

视频生成参数

图像相关参数

图生视频

参考图生视频

起始-结束帧生视频

样式参数（仅文生视频）

参数详细说明

模型功能支持

分辨率与时长支持

vidu-q1（文生视频、图生视频、参考图生视频、起始-结束帧生视频）

vidu-2.0（图生视频、参考图生视频、起始-结束帧生视频）

vidu-1.5（文生视频、图生视频、参考图生视频、起始-结束帧生视频）

图片要求

请求示例

文生视频 (Text-to-Video)

基础文生视频

带样式的文生视频

动漫风格文生视频

图生视频 (Image-to-Video)

基础图生视频（使用 URL）

图生视频（使用 Base64）

无提示词图生视频

参考图生视频 (Reference-to-Video)

单参考图生视频

多参考图生视频

起始-结束帧生视频 (Start-End Frame-to-Video)

双帧生成视频

高分辨率双帧生成

使用 Base64 的双帧生成