图片生成 | 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、viduq1 viduq2：支持文生图、图片编辑、参考生图 viduq1：支持参考生图
images	Array[String]	可选	图像参考 viduq2：支持输入 0～7 张图片 viduq1：支持输入 1～7 张图片模型将以此参数中传入的图片中的主题为参考，生成与图片中主体一致的视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问) 注2：图片支持 png、jpeg、jpg、webp格式注3：图片像素不能小于 128128，且比例需要小于1:4或者4:1 注4: 且大小不超过50M* 注5：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
prompt	String	是	文本提示词视频生成的文本描述，长度不能超过 2000 个字符注1：viduq2模型支持文生图，在使用viduq2模型，且没有上传任何images时，模型会使用该参数的文本内容生成图片
seed	Int	可选	随机种子参数当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
aspect_ratio	String	可选	比例参数，不同模型支持不同的比例： viduq1：默认值16:9，可选值：16:9、9:16、1:1、3:4、4:3 viduq2：默认值16:9，可选值如下：16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2 - auto：表示与首张输入图保持相同比例
resolution	String	可选	分辨率参数，不同模型支持的分辨率不同： viduq1：默认1080p，可选项：1080p viduq2：默认1080p，可选项：1080p、2K、4K
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的“status”包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

model

String

是

模型名称
可选值：viduq2、viduq1
viduq2：支持文生图、图片编辑、参考生图
viduq1：支持参考生图

images

Array[String]

可选

图像参考
viduq2：支持输入 0～7 张图片
viduq1：支持输入 1～7 张图片
模型将以此参数中传入的图片中的主题为参考，生成与图片中主体一致的视频。
注1：支持传入图片 Base64 编码或图片URL（确保可访问)
注2：图片支持 png、jpeg、jpg、webp格式
注3：图片像素不能小于 128*128，且比例需要小于1:4或者4:1
注4: 且大小不超过50M
注5：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如：

data:image/png;base64,{base64_encode}

prompt

String

是

文本提示词
视频生成的文本描述，长度不能超过 2000 个字符
注1：viduq2模型支持文生图，在使用viduq2模型，且没有上传任何images时，模型会使用该参数的文本内容生成图片

seed

Int

可选

随机种子参数
当默认不传或者传0时，会使用随机数替代
手动设置则使用设置的种子

aspect_ratio

String

可选

比例参数，不同模型支持不同的比例：
viduq1：默认值16:9，可选值：16:9、9:16、1:1、3:4、4:3
viduq2：默认值16:9，可选值如下：16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2
- auto：表示与首张输入图保持相同比例

resolution

String

可选

分辨率参数，不同模型支持的分辨率不同：
viduq1：默认1080p，可选项：1080p
viduq2：默认1080p，可选项：1080p、2K、4K

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	本次调用的模型名称
prompt	String	本次调用的提示词参数
images	Array[String]	本次调用的图像参数
seed	Int	本次调用的随机种子参数
aspect_ratio	String	本次调用的比例参数
resolution	String	本次调用的分辨率参数
callback_url	String	本次调用时传入的回调参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用的积分数
created_at	String	任务创建时间

字段

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

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

model

String

本次调用的模型名称

prompt

String

本次调用的提示词参数

images

Array[String]

本次调用的图像参数

seed

Int

本次调用的随机种子参数

aspect_ratio

String

本次调用的比例参数

resolution

String

本次调用的分辨率参数

callback_url

String

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

payload

String

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

credits

Int

本次调用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq2",
  "images": ["your_image_url1","your_image_url2","your_image_url3"],
  "prompt": "your_prompt",
  "seed": 0,
  "aspect_ratio":"16:9",
  "resolution":"2K",
  "payload": "",
  "credits": 12,
  "created_at": "2025-08-07T09:53:22.083033428Z"
}

字段	值	描述
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、viduq1 viduq2：支持文生图、图片编辑、参考生图 viduq1：支持参考生图
images	Array[String]	可选	图像参考 viduq2：支持输入 0～7 张图片 viduq1：支持输入 1～7 张图片模型将以此参数中传入的图片中的主题为参考，生成与图片中主体一致的视频。注1：支持传入图片 Base64 编码或图片URL（确保可访问) 注2：图片支持 png、jpeg、jpg、webp格式注3：图片像素不能小于 128128，且比例需要小于1:4或者4:1 注4: 且大小不超过50M* 注5：请注意，http请求的post body不超过20MB，且编码必须包含适当的内容类型字符串，例如： `data:image/png;base64,{base64_encode}`
prompt	String	是	文本提示词视频生成的文本描述，长度不能超过 2000 个字符注1：viduq2模型支持文生图，在使用viduq2模型，且没有上传任何images时，模型会使用该参数的文本内容生成图片
seed	Int	可选	随机种子参数当默认不传或者传0时，会使用随机数替代手动设置则使用设置的种子
aspect_ratio	String	可选	比例参数，不同模型支持不同的比例： viduq1：默认值16:9，可选值：16:9、9:16、1:1、3:4、4:3 viduq2：默认值16:9，可选值如下：16:9、9:16、1:1、3:4、4:3、21:9、2:3、3:2 - auto：表示与首张输入图保持相同比例
resolution	String	可选	分辨率参数，不同模型支持的分辨率不同： viduq1：默认1080p，可选项：1080p viduq2：默认1080p，可选项：1080p、2K、4K
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的“status”包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

model

String

是

模型名称
可选值：viduq2、viduq1
viduq2：支持文生图、图片编辑、参考生图
viduq1：支持参考生图

images

Array[String]

可选

data:image/png;base64,{base64_encode}

prompt

String

是

seed

Int

可选

随机种子参数
当默认不传或者传0时，会使用随机数替代
手动设置则使用设置的种子

aspect_ratio

String

可选

resolution

String

可选

分辨率参数，不同模型支持的分辨率不同：
viduq1：默认1080p，可选项：1080p
viduq2：默认1080p，可选项：1080p、2K、4K

payload

String

可选

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

callback_url

String

可选

字段	类型	描述
task_id	String	Vidu 生成的任务ID
state	String	处理状态可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
model	String	本次调用的模型名称
prompt	String	本次调用的提示词参数
images	Array[String]	本次调用的图像参数
seed	Int	本次调用的随机种子参数
aspect_ratio	String	本次调用的比例参数
resolution	String	本次调用的分辨率参数
callback_url	String	本次调用时传入的回调参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用的积分数
created_at	String	任务创建时间

字段

类型

描述

task_id

String

Vidu 生成的任务ID

state

String

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

model

String

本次调用的模型名称

prompt

String

本次调用的提示词参数

images

Array[String]

本次调用的图像参数

seed

Int

本次调用的随机种子参数

aspect_ratio

String

本次调用的比例参数

resolution

String

本次调用的分辨率参数

callback_url

String

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

payload

String

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

credits

Int

本次调用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq2",
  "images": ["your_image_url1","your_image_url2","your_image_url3"],
  "prompt": "your_prompt",
  "seed": 0,
  "aspect_ratio":"16:9",
  "resolution":"2K",
  "payload": "",
  "credits": 12,
  "created_at": "2025-08-07T09:53:22.083033428Z"
}

接口文档

接口文档

创建图像任务

创建图像任务