Skip to main content
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
required
Enum value: application/json
string
required
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
default:"general"
Output visual style; general is a realistic style, and anime is an anime style.Optional values: general, anime
string[]
required
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
default: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
default:5
Video duration (seconds)Value range: [1, 16]
boolean
default:false
Use off-peak pricing; when set to true, the task queues for off-peak processing to reduce costs.
boolean
default:false
Enable a watermark on the output video.
string
default:"720p"
Output video resolutionOptional values: 540p, 720p, 1080p
string
Watermark position on the videoOptional values: top-left, top-right, bottom-left, bottom-right
string
default:"16:9"
Output video aspect ratioOptional values: 16:9, 9:16, 4:3, 3:4, 1:1

Response

string
required
Use the task_id to request the Get Task Result API to retrieve the generated output.