Skip to main content
POST
Vidu Q3 Video
Seamless audio, elite action, and smart scene flow

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

prompt
string
required

Text prompt for video generation

Maximum string length: 3000
seed
integer | null

Random seed for reproducibility. If null, a random seed is chosen.

Required range: -9007199254740991 <= x <= 9007199254740991
duration
integer
default:8

Video duration in seconds

Required range: 1 <= x <= 16
resolution
enum<string>
default:720p

Output video resolution

Available options:
360p,
540p,
720p,
1080p
aspect_ratio
enum<string>
default:16:9

The aspect ratio of the output video

Available options:
16:9,
9:16,
1:1
first_frame_url
string<uri>

Input image for video generation

audio
boolean
default:false

Audio and video output capability

generate_audio
boolean
default:false

Whether to add background music to the video (only for 4-second videos)

n
integer
default:1

Number of results to generate (1-4)

Required range: 1 <= x <= 4

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Input · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.