简体中文

English

简体中文

English
EN

图生视频 ​

方法: POST路径: /vidu/v2/img2video

参数名称及描述 ​

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

示例格式 ​

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

请求参数 ​

Header 参数 ​

text
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json ​

text
model
string
必需
images
array
[string]
必需
prompt
string
必需
duration
integer
必需
seed
integer
必需
resolution
string
必需
movement_amplitude
string
必需
off_peak
boolean
必需
示例
{
"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 ​

bash
curl --location --request POST '/vidu/v2/img2video' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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
}'

返回响应 ​

🟢 200 成功 ​

内容类型: application/json

响应结构 ​

text
object

示例 ​

json
{
    "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": ""
}

YutoAI © 2021-2026