跳转到主要内容
POST
Vidu Q3 Pro Image-to-Video
The Vidu Q3 Pro image-to-video tool converts static images into dynamic videos, generating natural motion and smoother scene dynamics while maintaining subject consistency.
This is an asynchronous API and will only return the asynchronous task’s task_id. You should use this task_id to request the Get Task Result API to retrieve the generated result.

Request Headers

string
必填
Enum value: application/json
string
必填
Bearer authentication format: Bearer {{API Key}}.

Request Body

integer
Random seed for reproducible generation; 0 or omitted means random generation.Value range: [0, 2147483647]
string
Custom audio URL for the video’s background music; supports mp3, wav, m4a, and flac formats; maximum 20MB.
string
默认值:"general"
Output visual style; general is a realistic style, and anime is an anime style.Optional values: general, anime
string[]
必填
Array of reference image URLs; supports .jpg, .jpeg, .png, .webp. Each image must be no larger than 50MB; the aspect ratio must be between 1:4 and 4:1. Currently, only 1 input image is supported.
boolean
默认值:false
Enable audio-video matching; when set to true, the audio rhythm is synchronized with the video dynamics.
string
Motion description for video generation; describe scene motion, actions, and dynamic effects.Length limit: 0 - 1500
string
Custom watermark image URL; supports png, jpeg, jpg, and webp formats; maximum 10MB.
integer
默认值:5
Video duration (seconds)Value range: [1, 16]
boolean
默认值:false
Use off-peak pricing; when set to true, the task queues for off-peak processing to reduce costs.
boolean
默认值:false
Enable a watermark on the output video.
string
默认值:"720p"
Output video resolutionOptional values: 540p, 720p, 1080p
string
Watermark position on the videoOptional values: top-left, top-right, bottom-left, bottom-right
string
默认值:"16:9"
Output video aspect ratioOptional values: 16:9, 9:16, 4:3, 3:4, 1:1

Response

string
必填
Use the task_id to request the Get Task Result API to retrieve the generated output.
最后修改于 2026年7月3日