模版成片 | 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

参数名称	类型	必填	参数描述
story	String	是	模板成片参数可选值：love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot
images	Array[String]	是	图像模型将以此参数中传入的图片来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：图片支持 png、jpeg、jpg、webp格式；注3：图片比例要求，请查阅场景示例中心-模板成片-；注4：one_shot视频比例与输入首图的比例相同；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

story

String

是

模板成片参数
可选值：love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot

images

Array[String]

是

图像
模型将以此参数中传入的图片来生成视频。
注1：支持传入图片 Base64 编码或图片URL（确保可访问）；
注2：图片支持 png、jpeg、jpg、webp格式；
注3：图片比例要求，请查阅场景示例中心-模板成片-；
注4：one_shot视频比例与输入首图的比例相同；
注5：图片大小不超过 50 MB；
注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如：

data:image/png;base64,{base64_encode}

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 任务失败
story	String	本次调用的模板成片参数
images	Array[String]	本次调用的图像参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用使用的积分数
created_at	String	任务创建时间

字段

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

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

story

String

本次调用的模板成片参数

images

Array[String]

本次调用的图像参数

payload

String

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

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "story": "your_choose_value",
  "images": ["input_your_images"],
  "payload":"",
  "credits":credits_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

字段	值	描述
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

参数名称	类型	必填	参数描述
story	String	是	模板成片参数可选值：love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot
images	Array[String]	是	图像模型将以此参数中传入的图片来生成视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问）；注2：图片支持 png、jpeg、jpg、webp格式；注3：图片比例要求，请查阅场景示例中心-模板成片-；注4：one_shot视频比例与输入首图的比例相同；注5：图片大小不超过 50 MB；注6：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

story

String

是

模板成片参数
可选值：love_story、workday_feels、monkey_king、pigsy、monk_tang、one_shot

images

Array[String]

是

data:image/png;base64,{base64_encode}

payload

String

可选

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

callback_url

String

可选

字段	类型	描述
task_id	String	Vidu 生成的任务ID
state	String	处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
story	String	本次调用的模板成片参数
images	Array[String]	本次调用的图像参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用使用的积分数
created_at	String	任务创建时间

字段

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

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

story

String

本次调用的模板成片参数

images

Array[String]

本次调用的图像参数

payload

String

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

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "story": "your_choose_value",
  "images": ["input_your_images"],
  "payload":"",
  "credits":credits_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

接口文档

接口文档

创建视频任务

创建视频任务