图生视频

参数名称及描述

参数名称	类型	必填	参数描述
`model`	String	是	模型名称，可选值： - `viduq2-pro`: 新模型，效果好，细节丰富 - `viduq2-turbo`: 新模型，效果好，生成快 - `viduq1`: 画面清晰，平滑转场，运镜稳定 - `viduq1-classic`: 画面清晰，转场、运镜更丰富 - `vidu2.0`: 生成速度快 - `vidu1.5`: 动态幅度大
`images`	Array[String]	是	首帧图像。支持 Base64 编码或图片 URL，支持格式：png、jpeg、jpg、webp。图片比例需小于 1:4 或 4:1，大小不超过 50 MB。
`prompt`	String	可选	生成视频的文本描述，字符长度不超过 2000 个字符。
`is_rec`	Bool	可选	是否使用推荐提示词： - `true`: 系统自动推荐提示词，生成视频时使用推荐词（推荐提示词数量=1） - `false`: 使用自定义提示词生成视频。启用推荐提示词每个任务额外消耗10积分。
`duration`	Int	可选	视频时长，依据模型默认值设置： - `viduq2-pro`、`viduq2-turbo`、`viduq1`、`viduq1-classic`: 默认为 5秒，可选：1、2、3、4、5、6、7、8 - `vidu2.0`: 默认为 4秒，可选：4、8 - `vidu1.5`: 默认为 4秒，可选：4、8
`seed`	Int	可选	随机种子。默认不传或传0时使用随机数替代，手动设置则使用设置的种子。
`resolution`	String	可选	分辨率： - `viduq2-pro`: 1-8秒，默认 720p，可选：540p、720p、1080p - `viduq1`、`viduq1-classic`: 默认 1080p - `vidu2.0`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p - `vidu1.5`: 4秒默认 360p，8秒默认 720p，可选：360p、720p、1080p
`movement_amplitude`	String	可选	运动幅度：默认 `auto`，可选值：`auto`、`small`、`medium`、`large`
`bgm`	Bool	可选	是否添加背景音乐，默认为 `false`。若 `true`，系统自动挑选并添加合适音乐。
`payload`	String	可选	透传参数，最大字符长度为 1048576。
`off_peak`	Bool	可选	错峰模式，默认为 `false`，可选值：`true`（错峰生成），`false`（即时生成）。错峰模式消耗积分较低，任务会在48小时内生成。
`watermark`	Bool	可选	是否添加水印，`true` 表示添加水印，`false` 表示不添加。默认不加。
`wm_position`	Int	可选	水印位置： - 1: 左上角 - 2: 右上角 - 3: 右下角 - 4: 左下角默认：3
`wm_url`	String	可选	自定义水印内容的图片 URL，若不传，使用默认水印。
`meta_data`	String	可选	元数据标识，JSON 格式字符串，可自定义或使用示例格式。

示例格式

{
  "Label": "your_label",
  "ContentProducer": "yourcontentproducer",
  "ContentPropagator": "your_content_propagator",
  "ProduceID": "yourproductid",
  "PropagateID": "your_propagate_id",
  "ReservedCode1": "yourreservedcode1",
  "ReservedCode2": "your_reserved_code2"
}

请求参数

Header 参数

Body 参数application/json

示例

{
    "model": "viduq2-pro",
    "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": "720p",
    "movement_amplitude": "auto",
    "off_peak": false
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "task_id": "885482446060003328",
    "type": "img2video",
    "state": "created",
    "model": "viduq2-pro",
    "style": "general",
    "prompt": "The astronaut waved and the camera moved up.",
    "images": [
        "https://prod-ss-images.s3.cn-northwest-1.amazonaws.com.cn/vidu-maas/template/image2video.png"
    ],
    "duration": 5,
    "seed": 1283649749,
    "aspect_ratio": "",
    "resolution": "720p",
    "movement_amplitude": "auto",
    "created_at": "2025-11-10T15:03:01.749836088Z",
    "credits": 55,
    "payload": "",
    "cus_priority": 0,
    "off_peak": false,
    "watermark": false,
    "is_rec": false,
    "wm_position": "unspecified",
    "wm_url": "",
    "meta_data": ""
}

参数名称及描述#

示例格式#

请求参数

请求示例代码

返回响应

参数名称及描述

示例格式