Skip to main content
POST
VIDU Q2 Reference Image to Video
Generate new videos from reference images. Supports 540p, 720p, and 1080p resolutions.
This is an async API that only returns the task_id of the async task. Use the task_id to call the Get Async Task Result API to retrieve the generated result.

Request Headers

string
required
Enum: application/json
string
required
Bearer authentication format: Bearer {{API Key}}.

Request Body

boolean
default:false
Whether to add background music.
integer
Random seed for controlling the randomness of the generation result. The same seed produces similar results.
boolean
default:false
Whether to generate audio.
string
required
Text prompt. You can use @1, @2, etc. as placeholders to reference subjects.
integer
default:5
required
Video duration (in seconds). Supports 1-10 seconds.Possible values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
array
required
List of subjects. Each subject contains id, images, and voice_id.Array length: 1 - unlimited
boolean
default:false
Whether to add a watermark.
string
default:"720p"
Output video resolution. Default: 720p.Possible values: 540p, 720p, 1080p
string
Video aspect ratio, e.g., 16:9, 9:16, 1:1, etc.
string
Movement amplitude, controlling the intensity of object motion in the video.Possible values: auto, small, medium, high

Response

string
required
Use the task_id to call the Get Async Task Result API to retrieve the generated output.
string
Provider request ID (optional)