数字人 | 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	是	模型名称，默认用turbo 可选值：viduq2-turbo 、viduq2-pro
image	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	可选	文本提示词用于生成视频的文本描述，字符长度不能超过 2000 个字符。视频提示词，用来控制数字人的视频内容。
audio_url	String	可选	对口型音频与text仅生效一个，如果同时有值则audio_url生效
text	String	可选	对口型文本与audio_url仅生效一个，如果同时有值则audio_url生效
voice_id	String	可选	音色ID 仅在使用text时生效，可选音色列表如下：音色列表
resolution	String	可选	视频分辨率默认为720p，可选项为：540p、720p、1080p
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

model

String

是

模型名称，默认用turbo
可选值：viduq2-turbo 、viduq2-pro

image

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

可选

文本提示词
用于生成视频的文本描述，字符长度不能超过 2000 个字符。
视频提示词，用来控制数字人的视频内容。

audio_url

String

可选

对口型音频
与text仅生效一个，如果同时有值则audio_url生效

text

String

可选

对口型文本
与audio_url仅生效一个，如果同时有值则audio_url生效

voice_id

String

可选

音色ID
仅在使用text时生效，可选音色列表如下：音色列表

resolution

String

可选

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

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 任务失败
image	String	本次调用的图像参数
prompt	String	本次调用的提示词参数
audio_url	String	本次调用使用的音频url
text	String	本次调用使用的文本
voice_id	String	本次调用使用的音色id，仅使用text时生效
resolution	String	本次调用的分辨率参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用使用的积分数
created_at	String	任务创建时间

参数名称

类型

描述

task_id

String

Vidu生成的任务ID

state

String

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

image

String

本次调用的图像参数

prompt

String

本次调用的提示词参数

audio_url

String

本次调用使用的音频url

text

String

本次调用使用的文本

voice_id

String

本次调用使用的音色id，仅使用text时生效

resolution

String

本次调用的分辨率参数

payload

String

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

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "image": "your_image_url", 
  "prompt": "your_prompt",
  "audio_url": "your_audio_url",
  "resolution": "1080p",
  "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

参数名称	类型	必填	参数描述
model	String	是	模型名称，默认用turbo 可选值：viduq2-turbo 、viduq2-pro
image	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	可选	文本提示词用于生成视频的文本描述，字符长度不能超过 2000 个字符。视频提示词，用来控制数字人的视频内容。
audio_url	String	可选	对口型音频与text仅生效一个，如果同时有值则audio_url生效
text	String	可选	对口型文本与audio_url仅生效一个，如果同时有值则audio_url生效
voice_id	String	可选	音色ID 仅在使用text时生效，可选音色列表如下：音色列表
resolution	String	可选	视频分辨率默认为720p，可选项为：540p、720p、1080p
payload	String	可选	透传参数不做任何处理，仅数据传输注：最多 1048576个字符
callback_url	String	可选	Callback 协议需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致回调返回的"status"包括以下状态： - processing 任务处理中 - success 任务完成（如发送失败，回调三次） - failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：回调签名算法

参数名称

类型

必填

参数描述

model

String

是

模型名称，默认用turbo
可选值：viduq2-turbo 、viduq2-pro

image

String

是

data:image/png;base64,{base64_encode}

prompt

String

可选

文本提示词
用于生成视频的文本描述，字符长度不能超过 2000 个字符。
视频提示词，用来控制数字人的视频内容。

audio_url

String

可选

对口型音频
与text仅生效一个，如果同时有值则audio_url生效

text

String

可选

对口型文本
与audio_url仅生效一个，如果同时有值则audio_url生效

voice_id

String

可选

音色ID
仅在使用text时生效，可选音色列表如下：音色列表

resolution

String

可选

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

payload

String

可选

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

callback_url

String

可选

参数名称	类型	描述
task_id	String	Vidu生成的任务ID
state	String	可选值： created 创建成功 queueing 任务排队中 processing 任务处理中 success 任务成功 failed 任务失败
image	String	本次调用的图像参数
prompt	String	本次调用的提示词参数
audio_url	String	本次调用使用的音频url
text	String	本次调用使用的文本
voice_id	String	本次调用使用的音色id，仅使用text时生效
resolution	String	本次调用的分辨率参数
payload	String	本次调用时传入的透传参数
credits	Int	本次调用使用的积分数
created_at	String	任务创建时间

参数名称

类型

描述

task_id

String

Vidu生成的任务ID

state

String

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

image

String

本次调用的图像参数

prompt

String

本次调用的提示词参数

audio_url

String

本次调用使用的音频url

text

String

本次调用使用的文本

voice_id

String

本次调用使用的音色id，仅使用text时生效

resolution

String

本次调用的分辨率参数

payload

String

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

credits

Int

本次调用使用的积分数

created_at

String

任务创建时间

{
  "task_id": "your_task_id_here",
  "state": "created",
  "image": "your_image_url", 
  "prompt": "your_prompt",
  "audio_url": "your_audio_url",
  "resolution": "1080p",
  "payload": "",
  "credits": credits_number,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

接口文档

接口文档

创建其他任务

创建其他任务