视频延长 | 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
video_creation_id	String	可选	vidu视频Id，与 video_url 必填一个
video_url	String	可选	任意视频URL，与 video_creation_id 必填一个注：传入的视频时长不能低于4秒，不能超过1分钟
images	Array[String]	可选	延长到尾帧的参考图像模型将以此参数中传入的图片为尾帧画面来延长视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
prompt	String	可选	延长提示词，用来控制延长的视频内容
resolution	String	可选	视频分辨率，默认为720p，可选项为：540p、720p、1080p
duration	int	可选	延长时长，默认5s，可选项为 1～7 s
watermark	Bool	可选	是否添加水印 - true：添加水印； - false：不添加水印；注1：目前水印内容为固定，内容由AI生成，默认不加注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口
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

video_creation_id

String

可选

vidu视频Id，与 video_url 必填一个

video_url

String

可选

任意视频URL，与 video_creation_id 必填一个
注：传入的视频时长不能低于4秒，不能超过1分钟

images

Array[String]

可选

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

data:image/png;base64,{base64_encode}

prompt

String

可选

延长提示词，用来控制延长的视频内容

resolution

String

可选

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

duration

int

可选

延长时长，默认5s，可选项为 1～7 s

watermark

Bool

可选

是否添加水印
- true：添加水印；
- false：不添加水印；
注1：目前水印内容为固定，内容由AI生成，默认不加
注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口

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	本次调用的模型名称
video_creation_id	String	本次调用使用的vidu视频id，与 video_url 只出现一个
images	Array[String]	本次调用的图像参数
video_url	String	本次调用使用的视频url，与 video_creation_id 只出现一个
prompt	String	本次任务的提示词
duration	Int	本次调用的视频时长参数
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

本次调用的模型名称

video_creation_id

String

本次调用使用的vidu视频id，与 video_url 只出现一个

images

Array[String]

本次调用的图像参数

video_url

String

本次调用使用的视频url，与 video_creation_id 只出现一个

prompt

String

本次任务的提示词

duration

Int

本次调用的视频时长参数

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": "created",
    "model": "viduq2-turbo",
    "video_url": "your_video_url",
    "prompt": "your_prompt",
    "duration": 7,
    "resolution": "720p",
    "credits": 6,
    "created_at": "2025-08-29T06:48:29.368745805Z",
    "payload": "",
    "watermark": false
}

字段	值	描述
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
video_creation_id	String	可选	vidu视频Id，与 video_url 必填一个
video_url	String	可选	任意视频URL，与 video_creation_id 必填一个注：传入的视频时长不能低于4秒，不能超过1分钟
images	Array[String]	可选	延长到尾帧的参考图像模型将以此参数中传入的图片为尾帧画面来延长视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：只支持输入 1 张图；注3：图片支持 png、jpeg、jpg、webp格式；注4：图片比例需要小于 1:4 或者 4:1 ；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
prompt	String	可选	延长提示词，用来控制延长的视频内容
resolution	String	可选	视频分辨率，默认为720p，可选项为：540p、720p、1080p
duration	int	可选	延长时长，默认5s，可选项为 1～7 s
watermark	Bool	可选	是否添加水印 - true：添加水印； - false：不添加水印；注1：目前水印内容为固定，内容由AI生成，默认不加注2：您可以通过watermarked_url参数查询获取带水印的视频内容，详情见查询任务接口
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

video_creation_id

String

可选

vidu视频Id，与 video_url 必填一个

video_url

String

可选

任意视频URL，与 video_creation_id 必填一个
注：传入的视频时长不能低于4秒，不能超过1分钟

images

Array[String]

可选

data:image/png;base64,{base64_encode}

prompt

String

可选

延长提示词，用来控制延长的视频内容

resolution

String

可选

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

duration

int

可选

延长时长，默认5s，可选项为 1～7 s

watermark

Bool

可选

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	本次调用的模型名称
video_creation_id	String	本次调用使用的vidu视频id，与 video_url 只出现一个
images	Array[String]	本次调用的图像参数
video_url	String	本次调用使用的视频url，与 video_creation_id 只出现一个
prompt	String	本次任务的提示词
duration	Int	本次调用的视频时长参数
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

本次调用的模型名称

video_creation_id

String

本次调用使用的vidu视频id，与 video_url 只出现一个

images

Array[String]

本次调用的图像参数

video_url

String

本次调用使用的视频url，与 video_creation_id 只出现一个

prompt

String

本次任务的提示词

duration

Int

本次调用的视频时长参数

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": "created",
    "model": "viduq2-turbo",
    "video_url": "your_video_url",
    "prompt": "your_prompt",
    "duration": 7,
    "resolution": "720p",
    "credits": 6,
    "created_at": "2025-08-29T06:48:29.368745805Z",
    "payload": "",
    "watermark": false
}

接口文档

接口文档

创建其他任务

创建其他任务