Vidu 图生视频 viduq4-preview

使用 Vidu 最新旗舰模型（预览版）viduq4-preview 将图片转换为视频。该模型支持音画同出，支持自动切镜。提交任务后，请通过 GET /vidu/ent/v2/tasks/{task_id} 查询状态。 使用模型 viduq4-preview。

POST /vidu/ent/v2/img2video

cURL

basic_image_to_video

curl --request POST \
  --url https://baze-api.powerbuyin.top/vidu/ent/v2/img2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 0,
  "resolution": "1080p"
}
'

200

{
  "task_id": "your_task_id_here",
  "state": "created",
  "model": "viduq4-preview",
  "images": [
    "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
  ],
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 123456789,
  "resolution": "1080p",
  "payload": "",
  "credits": 10,
  "created_at": "2025-01-01T15:41:31.968916Z"
}

授权

Authorization · string · header · 必填

在请求头中传入 Authorization: Bearer <token>。

请求体

application/json

model · enum<string> · 必填

模型名称可选值：viduq4-preview

• viduq4-preview：Vidu最新旗舰模型（预览版），支持音画同出，支持自动切镜

可用选项: viduq4-preview

images · string[] · 必填

首帧图像 模型将以此参数中传入的图片为首帧画面来生成视频。 注1：支持传入图片 Base64 编码或图片URL（确保可访问）； 注2：只支持输入 1 张图； 注3：图片支持 png、jpeg、jpg、webp格式； 注4：图片大小不超过 50 MB； 注5：请注意，http body 需要小于20M，且编码必须包含适当的内容类型字符串，例如： data:image/png;base64,{base64_encode}

Required array length: 1 element

prompt · string

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

Maximum string length: 20000

audio · boolean · 默认值: true

是否使用音视频直出能力

• false：不需要音视频直出，输出静音视频
• true：需要音画同步，输出有声视频（包括台词和音效） 注：viduq4-preview 模型默认值为true

is_rec · boolean · 默认值: true

是否启用AI改写提示词功能

• true：启用
• false：不启用（默认值）

duration · integer · 默认值: 5

视频时长参数 默认值: 5 枚举值: 3 - 16

必填范围: 3 <= x <= 16

seed · integer

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

resolution · enum<string>

分辨率参数 默认值: 720p 枚举值: 540p / 720p / 1080p / 2K / 4K 注：viduq4-preview 支持 2K、4K 规格视频输出

可用选项: 540p, 720p, 1080p, 2K, 4K

payload · string

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

Maximum string length: 1048576

watermark · boolean · 默认值: true

是否添加水印

• true：添加水印
• false：不添加水印 注：目前水印内容为固定，内容由AI生成，默认不加

wm_position · enum<integer> · 默认值: 3

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

可用选项: 1, 2, 3, 4

必填范围: 1 <= x <= 4

wm_url · string

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

meta_data · string

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

callback_url · string

Callback 协议 需要您在创建任务时主动设置 callback_url，请求方法为 POST，当视频生成任务有状态变化时，Vidu 将向此地址发送包含任务最新状态的回调请求。回调请求内容结构与查询任务API的返回体一致 回调返回的"status"包括以下状态：

• processing 任务处理中
• success 任务完成（如发送失败，回调三次）
• failed 任务失败（如发送失败，回调三次） Vidu采用回调签名算法进行认证，详情见：https://platform.vidu.cn/docs/callback-signature

响应

200

application/json

提交成功，返回视频任务对象。

task_id · string

Vidu 生成的任务ID

state · enum<string>

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

可用选项: created, queueing, processing, success, failed

model · string

本次调用的模型名称

prompt · string

本次调用的提示词参数

images · string[]

本次调用的图像参数

sounds · string

本次调用的声音参数

duration · integer

本次调用的视频时长参数

seed · integer

本次调用的随机种子参数

resolution · string

本次调用的分辨率参数

payload · string

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

credits · integer

本次调用使用的积分数

watermark · boolean

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

created_at · string<date-time>

任务创建时间