Skip to main content
POST
VIDU Q2 Text to Video
Generate videos from text prompts. Supports three resolutions: 540p, 720p, and 1080p.
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 generation. The same seed produces similar results.
boolean
default:false
Whether to generate audio.
string
Video style, e.g. cinematic, realistic, artistic, etc.
string
required
Text prompt describing the desired video content in detail.Length limit: 1 - unlimited
integer
default:5
required
Video duration (seconds), supports 1-10 seconds.Possible values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
array
default:"[]"
Subject list. Each subject contains id, images, and voice_id (can be empty for text-to-video).
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)