Vidu Q-视频模型

Vidu Q3

首尾帧生视频

Q3 Pro 创建任务

POST/ent/v2/start-end2video

Q3 Pro 查询生成物

GET/ent/v2/tasks/{id}/creations

Q3 Turbo 创建任务

POST/ent/v2/start-end2video

Q3 Turbo 查询生成物

GET/ent/v2/tasks/{id}/creations

Q3 Pro Fast 创建任务

POST/ent/v2/start-end2video

Q3 Pro Fast 查询生成物

GET/ent/v2/tasks/{id}/creations

请求头

Authorizationstring*

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

示例值:Token {your api key}

Body 参数

modelstring*

模型名称，可选值：viduq3-pro：支持音画同步，支持智能切镜，旗舰模型

枚举值:viduq3-pro

imagesstring*

首帧与尾帧图像，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频

请求头

Authorizationstring*

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

示例值:Token {your api key}

路径参数

idstring*

任务id，由创建任务接口创建成功返回

返回结果

请求头

Authorizationstring*

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

示例值:Token {your api key}

Body 参数

modelstring*

模型名称，可选值：viduq3-turbo：支持音画同步，支持智能切镜，对比viduq3-pro，生成速度更快

枚举值:viduq3-turbo

imagesstring*

请求头

Authorizationstring*

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

示例值:Token {your api key}

路径参数

idstring*

任务id，由创建任务接口创建成功返回

返回结果

请求头

Authorizationstring*

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

示例值:Token {your api key}

Body 参数

modelstring*

模型名称，可选值：viduq3-pro-fast，高效生成优质音视频内容，生成速度更快，性价比高

枚举值:viduq3-pro-fast

imagesstring*

首帧与尾帧图像，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频

请求头

Authorizationstring*

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

示例值:Token {your api key}

路径参数

idstring*

任务id，由创建任务接口创建成功返回

返回结果

注1：支持传入图片 Base64 编码或图片URL（确保可访问）；

注2：只支持输入 1 张图；

注3：图片支持 png、jpeg、jpg、webp格式；

注4：首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间，图片比例需要小于 1:4 或者 4:1 ；

注5：图片大小不超过 50 MB；

注6：请注意，http body 需要小于20M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}

promptstring

文本提示词，生成视频的文本描述。
注1：字符长度不能超过 20000 个字符

audioboolean

是否使用音视频直出能力，枚举值为：
- true：输出带台词以及背景音的视频，默认值
- false：输出静音视频

默认值:true

枚举值:truefalse

durationinteger

输出的视频时长

默认值:5

枚举值:1 - 16

seedinteger

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

默认值:0

resolutionstring

输出视频的分辨率参数

默认值:720p

枚举值:540p720p1080p

payloadstring

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

off_peakboolean

错峰模式，可选值：
- true：错峰生成视频；
- false：即时生成视频，默认值；
注1：错峰模式消耗的积分更低，具体请查看产品定价
注2：错峰模式下提交的任务，会在48小时内生成，未能完成的任务会被自动取消，并返还该任务的积分；
注3：您也可以手动取消错峰任务

默认值:false

枚举值:true

watermarkboolean

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

默认值:true

枚举值:truefalse

wm_positioninteger

水印位置，表示水印出现在图片的位置，可选项为：
- 1：左上角
- 2：右上角
- 3：右下角，默认值
- 4：左下角

默认值:3

枚举值:1234

wm_urlstring

水印内容，此处为图片URL，不传时，使用默认水印：内容由AI生成

meta_datastring

元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式，示例如下
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
该参数为空时，默认使用vidu生成的元数据标识

callback_urlstring

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

首帧与尾帧图像，上传的第一张图片视作首帧图，第二张图片视作尾帧图，模型将以此参数中传入的图片来生成视频

注1：支持传入图片 Base64 编码或图片URL（确保可访问）；

注2：只支持输入 1 张图；

注3：图片支持 png、jpeg、jpg、webp格式；

注4：首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间，图片比例需要小于 1:4 或者 4:1 ；

注5：图片大小不超过 50 MB；

注6：请注意，http body 需要小于20M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}

示例值:data:image/png

promptstring

文本提示词，生成视频的文本描述。
注1：字符长度不能超过 20000 个字符

audioboolean

是否使用音视频直出能力，枚举值为：
- true：输出带台词以及背景音的视频，默认值
- false：输出静音视频

默认值:true

枚举值:truefalse

durationinteger

输出的视频时长

默认值:5

枚举值:1 - 16

seedinteger

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

resolutionstring

输出视频的分辨率参数

默认值:720p

枚举值:540p720p1080p

payloadstring

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

off_peakboolean

错峰模式，可选值：
- true：错峰生成视频；
- false：即时生成视频，默认值；
注1：错峰模式消耗的积分更低，具体请查看产品定价
注2：错峰模式下提交的任务，会在48小时内生成，未能完成的任务会被自动取消，并返还该任务的积分；
注3：您也可以手动取消错峰任务

默认值:false

枚举值:true

watermarkboolean

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

默认值:true

枚举值:truefalse

wm_positioninteger

水印位置，表示水印出现在图片的位置，可选项为：
- 1：左上角
- 2：右上角
- 3：右下角，默认值
- 4：左下角

默认值:3

枚举值:1234

wm_urlstring

水印内容，此处为图片URL，不传时，使用默认水印：内容由AI生成

meta_datastring

元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式，示例如下
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
该参数为空时，默认使用vidu生成的元数据标识

callback_urlstring

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

注1：支持传入图片 Base64 编码或图片URL（确保可访问）；

注2：只支持输入 1 张图；

注3：图片支持 png、jpeg、jpg、webp格式；

注4：首尾帧两张输入图的分辨率需相近，首帧图的分辨率/尾帧图的分辨率要在0.8～1.25之间，图片比例需要小于 1:4 或者 4:1 ；

注5：图片大小不超过 50 MB；

注6：请注意，http body 需要小于20M，且编码必须包含适当的内容类型字符串，例如：data:image/png;base64,{base64_encode}

示例值:data:image/png

promptstring

文本提示词，生成视频的文本描述。
注1：字符长度不能超过 20000 个字符

audioboolean

是否使用音视频直出能力，枚举值为：
- true：输出带台词以及背景音的视频，默认值
- false：输出静音视频

durationinteger

输出的视频时长

默认值:5

枚举值:1 - 16

seedinteger

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

resolutionstring

输出视频的分辨率参数

默认值:720p

枚举值:720p1080p

payloadstring

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

off_peakboolean

错峰模式，可选值：
- true：错峰生成视频；
- false：即时生成视频，默认值；
注1：错峰模式消耗的积分更低，具体请查看产品定价
注2：错峰模式下提交的任务，会在48小时内生成，未能完成的任务会被自动取消，并返还该任务的积分；
注3：您也可以手动取消错峰任务

默认值:false

枚举值:truefalse

watermarkboolean

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

默认值:true

枚举值:truefalse

wm_positioninteger

水印位置，
- 1：左上角
- 2：右上角
- 3：右下角，默认值
- 4：左下角

默认值:3

枚举值:1234

wm_urlstring

水印内容，此处为图片URL，不传时，使用默认水印：内容由AI生成

meta_datastring

元数据标识，json格式字符串，透传字段，您可以自定义格式或使用示例格式，示例如下：
{
"Label": "your_label","ContentProducer": "yourcontentproducer","ContentPropagator": "your_content_propagator","ProduceID": "yourproductid", "PropagateID": "your_propagate_id","ReservedCode1": "yourreservedcode1", "ReservedCode2": "your_reserved_code2"
}
该参数为空时，默认使用vidu生成的元数据标识

callback_urlstring

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

200OKapplication/json

返回参数

idstring

任务ID

statestring

处理状态，可选值：
- created 创建成功
- queueing 任务排队中
- processing 任务处理中

200OKapplication/json

返回参数

idstring

任务ID

statestring

处理状态，可选值：
- created 创建成功
- queueing 任务排队中
- processing 任务处理中

200OKapplication/json

返回参数

idstring

任务ID

statestring

处理状态，可选值：
- created 创建成功
- queueing 任务排队中
- processing 任务处理中

success 任务成功

failed 任务失败

err_codestring

错误码，具体见错误码表

creditsinteger

该任务消耗的积分数量，单位：积分

payloadstring

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

off_peakboolean

本次任务调用是否使用错峰模式

creationsarray

生成物结果

idstring

生成物id，用来标识不同的生成物

urlstring

生成物URL， 24小时有效期

cover_urlstring

生成物封面，24小时有效期

watermarked_urlstring

success 任务成功

failed 任务失败

err_codestring

错误码，具体见错误码表

creditsinteger

该任务消耗的积分数量，单位：积分

payloadstring

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

off_peakboolean

本次任务调用是否使用错峰模式

creationsarray

生成物结果

idstring

生成物id，用来标识不同的生成物

urlstring

生成物URL， 24小时有效期

cover_urlstring

生成物封面，24小时有效期

watermarked_urlstring

success 任务成功

failed 任务失败

err_codestring

错误码，具体见错误码表

creditsinteger

该任务消耗的积分数量，单位：积分

payloadstring

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

off_peakboolean

本次任务调用是否使用错峰模式

creationsarray

生成物结果

idstring

生成物id，用来标识不同的生成物

urlstring

生成物URL， 24小时有效期

cover_urlstring

生成物封面，24小时有效期

watermarked_urlstring

200OKapplication/json

返回参数

task_idstring

Vidu 生成的任务ID

statestring

处理状态，可选值：
- created 创建成功
- queueing 任务排队中
- processing 任务处理中

200OKapplication/json

返回参数

task_idstring

Vidu 生成的任务ID

statestring

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

modelstring

本次调用的模型名称

promptstring

本次调用的提示词参数

images

200OKapplication/json

返回参数

task_idstring

Vidu 生成的任务ID

statestring

处理状态，可选值：
- created 创建成功
- queueing 任务排队中
- processing 任务处理中

带水印的生成物url，24小时有效期

success 任务成功

failed 任务失败

modelstring

本次调用的模型名称

promptstring

本次调用的提示词参数

imagesstring

本次调用的图像参数

durationinteger

本次调用的视频时长参数

seedinteger

本次调用的随机种子参数

resolutionstring

本次调用的分辨率参数

payloadstring

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

off_peakboolean

本次调用时是否使用错峰模式

creditsinteger

本次调用使用的积分数

watermarkboolean

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

created_atstring

任务创建时间

本次调用的图像参数

durationinteger

本次调用的视频时长参数

seedinteger

本次调用的随机种子参数

resolutionstring

本次调用的分辨率参数

payloadstring

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

off_peakboolean

本次调用时是否使用错峰模式

creditsinteger

本次调用使用的积分数

watermarkboolean

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

created_atstring

任务创建时间

success 任务成功

failed 任务失败

modelstring

本次调用的模型名称

promptstring

本次调用的提示词参数

imagesstring

本次调用的图像参数

durationinteger

本次调用的视频时长参数

seedinteger

本次调用的随机种子参数

resolutionstring

本次调用的分辨率参数

payloadstring

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

off_peakboolean

本次调用时是否使用错峰模式

creditsinteger

本次调用使用的积分数

watermarkboolean

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

created_atstring

任务创建时间

请求示例

curl --request POST \
  --url 'https://api.vidu.cn/ent/v2/start-end2video' \
  --header 'Authorization: Token {your api key}' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq3-pro",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg",
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"
  ],
  "prompt": "The camera zooms in on the bird, which then flies to the right. With its flight being smooth and natural, the bird soars in the sky. with a red light effect following and surrounding it from behind.",
  "audio": true,
  "duration": 5,
  "seed": 0,
  "resolution": "720p",
  "payload": "string",
  "off_peak": false,
  "watermark": true,
  "wm_position": 3,
  "wm_url": "string",
  "meta_data": "string",
  "callback_url": "string"
}'

200

返回示例

        {
          "task_id": "your_task_id_here",
          "state": "created",
          "model": "viduq3-pro",
          "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
          "prompt": "The camera zooms in on the bird, which then flies to the right. The bird's flight is smooth and natural, with a red light effect following and surrounding it from behind.",
          "duration": 5,
          "seed": random_number,
          "resolution": "1080p",
          "movement_amplitude": "auto",
          "payload":"",
          "off_peak": false,
          "credits":credits_number,
          "created_at": "2025-01-01T15:41:31.968916Z"
        }

请求示例

curl --request GET \
  --url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
  --header 'Authorization: Token {your api key}'

200

返回示例

{
  "id":"your_task_id",
  "state": "success",
  "err_code": "",
  "credits": 4,
  "payload": "",
  "creations": [
    {
      "id": "your_creations_id",
      "url": "your_generated_results_url",
      "cover_url": "your_generated_results_cover_url",
      "watermarked_url": "your_generated_results_watermarked_url"
    }
  ]
}

请求示例

curl --request POST \
  --url 'https://api.vidu.cn/ent/v2/start-end2video' \
  --header 'Authorization: Token {your api key}' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq3-turbo",
  "images": "data:image/png",
  "prompt": "string",
  "audio": true,
  "duration": 5,
  "seed": 0,
  "resolution": "720p",
  "payload": "string",
  "off_peak": false,
  "watermark": true,
  "wm_position": 3,
  "wm_url": "string",
  "meta_data": "string",
  "callback_url": "string"
}'

200

返回示例

        {
          "task_id": "your_task_id_here",
          "state": "created",
          "model": "viduq3-turbo",
          "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
          "prompt": "The camera zooms in on the bird, which then flies to the right. The bird's flight is smooth and natural, with a red light effect following and surrounding it from behind.",
          "duration": 5,
          "seed": random_number,
          "resolution": "1080p",
          "payload":"",
          "credits":credits_number,
          "created_at": "2025-01-01T15:41:31.968916Z"
        }

请求示例

curl --request GET \
  --url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
  --header 'Authorization: Token {your api key}'

200

返回示例

{
  "id":"your_task_id",
  "state": "success",
  "err_code": "",
  "credits": 4,
  "payload": "",
  "creations": [
    {
      "id": "your_creations_id",
      "url": "your_generated_results_url",
      "cover_url": "your_generated_results_cover_url",
      "watermarked_url": "your_generated_results_watermarked_url"
    }
  ]
}

请求示例

curl --request POST \
  --url 'https://api.vidu.cn/ent/v2/start-end2video' \
  --header 'Authorization: Token {your api key}' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "viduq3-pro-fast",
  "images": "data:image/png",
  "prompt": "The camera zooms in on the bird, which then flies to the right. With its flight being smooth and natural, the bird soars in the sky. with a red light effect following and surrounding it from behind.",
  "audio": true,
  "duration": 5,
  "seed": 0,
  "resolution": "720p",
  "payload": "string",
  "off_peak": false,
  "watermark": true,
  "wm_position": 3,
  "wm_url": "string",
  "meta_data": "string",
  "callback_url": "string"
}'

200

返回示例

        {
          "task_id": "your_task_id_here",
          "state": "created",
          "model": "viduq3-pro-fast",
          "images": ["https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-1.jpeg","https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/startend2video-2.jpeg"],
          "prompt": "The camera zooms in on the bird, which then flies to the right. The bird's flight is smooth and natural, with a red light effect following and surrounding it from behind.",
          "duration": 5,
          "seed": random_number,
          "resolution": "1080p",
          "payload":"",
          "credits":credits_number,
          "created_at": "2025-01-01T15:41:31.968916Z"
        }

请求示例

curl --request GET \
  --url 'https://api.vidu.cn/ent/v2/tasks/{your_id}/creations' \
  --header 'Authorization: Token {your api key}'

200

返回示例

{
  "id":"your_task_id",
  "state": "success",
  "err_code": "",
  "credits": 4,
  "payload": "",
  "creations": [
    {
      "id": "your_creations_id",
      "url": "your_generated_results_url",
      "cover_url": "your_generated_results_cover_url",
      "watermarked_url": "your_generated_results_watermarked_url"
    }
  ]
}

功能

帮助文档

关于我们

功能

帮助文档

关于我们

Vidu Q3

首尾帧生视频

Q3 Pro 创建任务

Q3 Pro 查询生成物

Q3 Turbo 创建任务

Q3 Turbo 查询生成物

Q3 Pro Fast 创建任务

Q3 Pro Fast 查询生成物

请求头

Body 参数

请求头

路径参数

返回结果

请求头

Body 参数

请求头

路径参数

返回结果

请求头

Body 参数

请求头

路径参数

返回结果

返回结果

返回结果

返回结果

搜索文档

功能

帮助文档

关于我们

搜索文档

功能

帮助文档

关于我们

Vidu Q3

首尾帧生视频

Q3 Pro 创建任务

Q3 Pro 查询生成物

Q3 Turbo 创建任务

Q3 Turbo 查询生成物

Q3 Pro Fast 创建任务

Q3 Pro Fast 查询生成物

请求头

Body 参数

请求头

路径参数

返回结果

请求头

Body 参数

请求头

路径参数

返回结果

请求头

Body 参数

请求头

路径参数

返回结果

返回结果

返回结果

返回结果