Skip to main content
POST

Authorization

string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Request Parameters

string
required
Video generation model nameSupported models:
  • viduq3-pro - Vidu Q3 Pro
  • viduq3-turbo - Vidu Q3 Turbo
string
required
Text prompt, maximum 2000 charactersRequired for text-to-video. Optional for image-to-video and first-last frame modes.Example: "A cat playing piano, camera slowly zooms in"
integer
default:"5"
Video duration (seconds)Range: 1 to 16Default: 5
string
default:"720p"
Video resolutionOptions:
  • 540p - Standard definition
  • 720p - HD (default)
  • 1080p - Full HD
Default: 720p
string
Video aspect ratio (only for text-to-video mode)Options:
  • 16:9 - Landscape
  • 9:16 - Portrait
  • 4:3 - Traditional
  • 3:4 - Portrait traditional
  • 1:1 - Square
This parameter is only available in text-to-video mode (when image_urls is not provided).
array<url>
Image URL array for image-to-video generationThe system automatically determines the generation mode based on the number of images:
  • 0 images (not provided): Text-to-video mode
  • 1 image: Image-to-video mode (image used as starting frame)
  • 2 images: First-last frame mode (first image = first frame, second image = last frame)
Example: ["https://example.com/photo.jpg"]
  • Maximum 2 images supported
  • For first-last frame mode, exactly 2 images must be provided
  • When image_urls is provided (whether 1 or 2 images), the aspect_ratio parameter cannot be used — the video aspect ratio will be automatically determined by the image
boolean
default:"true"
Whether to generate audio (dialogue, sound effects)Default: trueSet to false if you need a silent video.
integer
Seed integer used to control randomness in generated contentRange: integer between -1 and 2^32-1
  • With the same request, different seed values (including unspecified or -1, which uses a random number instead) will produce different results
  • With the same request, the same seed value will produce similar results, but exact reproducibility is not guaranteed

Auto Routing

The system automatically determines the generation mode based on the number of images in image_urls:

Parameter Support Matrix

Response

integer
Response status code, 200 on success
array
Response data array

Use Cases

Case 1: Text-to-Video

Case 2: Image-to-Video (Single Image)

Case 3: First-Last Frame Video

Case 4: Silent Video (Audio Disabled)

Query Task ResultsVideo generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.