智能多帧 | Vidu API

当前页面

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将 {your api key} 替换为您的 token

字段

值

描述

Content-Type

application/json

数据交换格式

Authorization

Token {your api key}

将 {your api key} 替换为您的 token

参数名称	子参数	类型	必填	参数描述
model		String	是	模型名称可选值：viduq2-turbo 、viduq2-pro
start_image		String	是	首帧图像注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过10MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
image_settings		Array	是	关键帧配置，每个任务最多9个关键帧，最少2个关键帧
	prompt	String	可选	上一张图像继续延长的提示词，用来控制延长的视频内容
	key_image	String	是	中间帧的参考图像模型将此参数中的图片作为尾帧生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：输入顺序即为时间轴顺序（从首帧到尾帧）；注4：图片支持 png、jpeg、jpg、webp格式；注5：图片比例需要小于 1:4 或者 4:1 ；注6：图片大小不超过 50 MB；注7：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
	duration	Int	可选	多帧时长不同关键帧之间的视频时长，默认5s，可选项为 2～7 s
resolution		String	可选	视频分辨率默认为720p，可选项为：540p、720p、1080p
watermark		Bool	可选	是否添加水印 - true：添加水印； - false：不添加水印；注1：目前水印内容为固定，内容由AI生成，默认不加
wm_url		String	可选	水印内容，此处为水印图片URL 启用水印但不传自定义水印URL时，使用默认水印：内容由AI生成不添加水印则该参数无效
wm_position		String	可选	水印位置，默认为左下，枚举值如下： - top_left：左上 - top_right：右上 - bottom_right：右下 - bottom_left：左下不添加水印则该参数无效
meta_data		String	可选	元数据标识，JSON格式字符串，建议使用以下标准格式，也可以使用其他格式，透传字段 \{ “Label”: “1”, “ContentProducer”: “your_ContentProducer”, “ContentPropagator”: “your_ContentPropagator”, “ProduceID”: “your_ProduceID”, “PropagateID”: “your_PropagateID”, “ReservedCode1”: “your_ReservedCode1”, “ReservedCode2”: “your_ReservedCode2” \}
payload		String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url		String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

子参数

类型

必填

参数描述

model

String

是

模型名称
可选值：viduq2-turbo 、viduq2-pro

start_image

String

是

首帧图像
注1：支持传入图片 Base64 编码或图片URL（确保可访问）；
注2：只支持输入 1 张图；
注3：图片支持 png、jpeg、jpg、webp格式；
注4：图片比例需要小于 1:4 或者 4:1 ；
注5：图片大小不超过 50 MB；
注6：请注意，http请求的post body不超过10MB，且编码必须包含适当的内容类型字符串，例如：

data:image/png;base64,{base64_encode}

image_settings

Array

是

关键帧配置，每个任务最多9个关键帧，最少2个关键帧

prompt

String

可选

上一张图像继续延长的提示词，用来控制延长的视频内容

key_image

String

是

中间帧的参考图像
模型将此参数中的图片作为尾帧生成视频。
注1：支持传入图片 Base64 编码或图片URL（确保可访问）；
注2：只支持输入 1 张图；
注3：输入顺序即为时间轴顺序（从首帧到尾帧）；
注4：图片支持 png、jpeg、jpg、webp格式；
注5：图片比例需要小于 1:4 或者 4:1 ；
注6：图片大小不超过 50 MB；
注7：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如：

data:image/png;base64,{base64_encode}

duration

Int

可选

多帧时长
不同关键帧之间的视频时长，默认5s，可选项为 2～7 s

resolution

String

可选

视频分辨率
默认为720p，可选项为：540p、720p、1080p

watermark

Bool

可选

是否添加水印
- true：添加水印；
- false：不添加水印；
注1：目前水印内容为固定，内容由AI生成，默认不加

wm_url

String

可选

水印内容，此处为水印图片URL
启用水印但不传自定义水印URL时，使用默认水印：内容由AI生成
不添加水印则该参数无效

wm_position

String

可选

水印位置，默认为左下，枚举值如下：
- top_left：左上
- top_right：右上
- bottom_right：右下
- bottom_left：左下
不添加水印则该参数无效

meta_data

String

可选

元数据标识，JSON格式字符串，建议使用以下标准格式，也可以使用其他格式，透传字段
\{
“Label”: “1”,
“ContentProducer”: “your_ContentProducer”,
“ContentPropagator”: “your_ContentPropagator”,
“ProduceID”: “your_ProduceID”,
“PropagateID”: “your_PropagateID”,
“ReservedCode1”: “your_ReservedCode1”,
“ReservedCode2”: “your_ReservedCode2”
\}

payload

String

可选

透传参数
不做任何处理，仅数据传输
注：最多 1048576个字符

callback_url

String

可选

Callback 协议
需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致
回调返回的"status"包括以下状态：
- processing 任务处理中
- success 任务完成（如发送失败，回调三次）
- failed 任务失败（如发送失败，回调三次）
Vidu采用回调签名算法进行认证，详情见：回调签名算法

字段	子参数	类型	描述
task_id		String	Vidu 生成的任务ID
state		String	处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
model		String	本次调用的模型名称
start_image		String	本次调用的首帧图像参数
image_settings		Array	本次调用的多帧配置信息
	prompt	String	本次任务的提示词
	key_image	String	本次调用的尾帧图像参数
	duration	String	本次调用的时长
resolution		String	本次调用的分辨率参数
watermark		Bool	本次提交任务是否使用水印
wm_url		String	本次任务使用的水印内容
wm_position		String	本次任务使用的水印位置
meta_data		String	本次任务使用的元数据标识信息
payload		String	本次调用时传入的透传参数
credits		Int	本次调用使用的积分数
created_at		String	任务创建时间

字段

子参数

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败

model

String

本次调用的模型名称

start_image

String

本次调用的首帧图像参数

image_settings

Array

本次调用的多帧配置信息

prompt

String

本次任务的提示词

key_image

String

本次调用的尾帧图像参数

duration

String

本次调用的时长

resolution

String

本次调用的分辨率参数

watermark

Bool

本次提交任务是否使用水印

wm_url

String

本次任务使用的水印内容

wm_position

String

本次任务使用的水印位置

meta_data

String

本次任务使用的元数据标识信息

payload

String

本次调用时传入的透传参数

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
    "task_id": "your_task_id",
    "state": "success",
    "model": "viduq2-turbo",
    "start_image": "your_start_image",
    "image_settings": [
        {
            "key_image": "your_key_image1",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image2",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image3",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image4",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image5",
            "prompt": "",
            "duration": 5
        }
    ],
    "resolution": "1080p",
    "watermark": false,
    "wm_url": "",
    "wm_position": "unspecified",
    "meta_data": "",
    "payload": "",
    "credits": 40,
    "created_at": "2025-11-11T03:07:57.538965937Z"
}

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token {your api key}	将 {your api key} 替换为您的 token

字段

值

描述

Content-Type

application/json

数据交换格式

Authorization

Token {your api key}

将 {your api key} 替换为您的 token

参数名称	子参数	类型	必填	参数描述
model		String	是	模型名称可选值：viduq2-turbo 、viduq2-pro
start_image		String	是	首帧图像注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过10MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
image_settings		Array	是	关键帧配置，每个任务最多9个关键帧，最少2个关键帧
	prompt	String	可选	上一张图像继续延长的提示词，用来控制延长的视频内容
	key_image	String	是	中间帧的参考图像模型将此参数中的图片作为尾帧生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：输入顺序即为时间轴顺序（从首帧到尾帧）；注4：图片支持 png、jpeg、jpg、webp格式；注5：图片比例需要小于 1:4 或者 4:1 ；注6：图片大小不超过 50 MB；注7：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
	duration	Int	可选	多帧时长不同关键帧之间的视频时长，默认5s，可选项为 2～7 s
resolution		String	可选	视频分辨率默认为720p，可选项为：540p、720p、1080p
watermark		Bool	可选	是否添加水印 - true：添加水印； - false：不添加水印；注1：目前水印内容为固定，内容由AI生成，默认不加
wm_url		String	可选	水印内容，此处为水印图片URL 启用水印但不传自定义水印URL时，使用默认水印：内容由AI生成不添加水印则该参数无效
wm_position		String	可选	水印位置，默认为左下，枚举值如下： - top_left：左上 - top_right：右上 - bottom_right：右下 - bottom_left：左下不添加水印则该参数无效
meta_data		String	可选	元数据标识，JSON格式字符串，建议使用以下标准格式，也可以使用其他格式，透传字段 \{ “Label”: “1”, “ContentProducer”: “your_ContentProducer”, “ContentPropagator”: “your_ContentPropagator”, “ProduceID”: “your_ProduceID”, “PropagateID”: “your_PropagateID”, “ReservedCode1”: “your_ReservedCode1”, “ReservedCode2”: “your_ReservedCode2” \}
payload		String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url		String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

子参数

类型

必填

参数描述

model

String

是

模型名称
可选值：viduq2-turbo 、viduq2-pro

start_image

String

是

data:image/png;base64,{base64_encode}

image_settings

Array

是

关键帧配置，每个任务最多9个关键帧，最少2个关键帧

prompt

String

可选

上一张图像继续延长的提示词，用来控制延长的视频内容

key_image

String

是

data:image/png;base64,{base64_encode}

duration

Int

可选

多帧时长
不同关键帧之间的视频时长，默认5s，可选项为 2～7 s

resolution

String

可选

视频分辨率
默认为720p，可选项为：540p、720p、1080p

watermark

Bool

可选

是否添加水印
- true：添加水印；
- false：不添加水印；
注1：目前水印内容为固定，内容由AI生成，默认不加

wm_url

String

可选

水印内容，此处为水印图片URL
启用水印但不传自定义水印URL时，使用默认水印：内容由AI生成
不添加水印则该参数无效

wm_position

String

可选

水印位置，默认为左下，枚举值如下：
- top_left：左上
- top_right：右上
- bottom_right：右下
- bottom_left：左下
不添加水印则该参数无效

meta_data

String

可选

payload

String

可选

透传参数
不做任何处理，仅数据传输
注：最多 1048576个字符

callback_url

String

可选

字段	子参数	类型	描述
task_id		String	Vidu 生成的任务ID
state		String	处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
model		String	本次调用的模型名称
start_image		String	本次调用的首帧图像参数
image_settings		Array	本次调用的多帧配置信息
	prompt	String	本次任务的提示词
	key_image	String	本次调用的尾帧图像参数
	duration	String	本次调用的时长
resolution		String	本次调用的分辨率参数
watermark		Bool	本次提交任务是否使用水印
wm_url		String	本次任务使用的水印内容
wm_position		String	本次任务使用的水印位置
meta_data		String	本次任务使用的元数据标识信息
payload		String	本次调用时传入的透传参数
credits		Int	本次调用使用的积分数
created_at		String	任务创建时间

字段

子参数

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

处理状态
可选值：
created 创建成功
queueing 任务排队中
processing 任务处理中
success 任务成功
failed 任务失败

model

String

本次调用的模型名称

start_image

String

本次调用的首帧图像参数

image_settings

Array

本次调用的多帧配置信息

prompt

String

本次任务的提示词

key_image

String

本次调用的尾帧图像参数

duration

String

本次调用的时长

resolution

String

本次调用的分辨率参数

watermark

Bool

本次提交任务是否使用水印

wm_url

String

本次任务使用的水印内容

wm_position

String

本次任务使用的水印位置

meta_data

String

本次任务使用的元数据标识信息

payload

String

本次调用时传入的透传参数

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
    "task_id": "your_task_id",
    "state": "success",
    "model": "viduq2-turbo",
    "start_image": "your_start_image",
    "image_settings": [
        {
            "key_image": "your_key_image1",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image2",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image3",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image4",
            "prompt": "",
            "duration": 5
        },
        {
            "key_image": "your_key_image5",
            "prompt": "",
            "duration": 5
        }
    ],
    "resolution": "1080p",
    "watermark": false,
    "wm_url": "",
    "wm_position": "unspecified",
    "meta_data": "",
    "payload": "",
    "credits": 40,
    "created_at": "2025-11-11T03:07:57.538965937Z"
}

接口文档

接口文档

创建视频任务

创建视频任务