Skip to main content
POST
VIDU Q2 Reference-to-Video
Generate a new video from reference images. Supports three resolutions: 540p, 720p, and 1080p.
This is an asynchronous API and will only return the async 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

boolean
default:false
Whether to add background music
integer
Random seed used to control the randomness of the generated result. The same seed will produce similar results.
boolean
default:false
Whether to generate audio
string
required
Text prompt. You can use placeholders such as @1 and @2 to reference subjects
integer
default:5
required
Video duration (seconds). Supports 1-10 secondsOptional values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
object[]
required
Subject list. Each subject contains id, images, and voice_idArray length: 1 - unlimited
boolean
default:false
Whether to add a watermark
string
default:"720p"
Output video resolution. The default value is 720p.Optional values: 540p, 720p, 1080p
string
Video aspect ratio, such as 16:9, 9:16, 1:1, etc.
string
Movement amplitude, which controls the movement intensity of objects in the videoOptional values: auto, small, medium, high

Response

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