Skip to main content
POST
VIDU Q2 Pro Multi-frame to Video
Generate coherent videos from multiple keyframe 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

string
Watermark image URL. When watermark is enabled but no custom watermark URL is provided, the default watermark is used. This parameter has no effect if watermark is disabled.
string
Pass-through parameter. No processing is performed; data is transmitted as-is. Maximum 1,048,576 characters.
string
Metadata identifier as a JSON-formatted string. Pass-through field.
boolean
default:false
Whether to add a watermark. true: add watermark. false: no watermark. Default: no watermark.
string
default:"720p"
Video resolution. Default: 720p.Possible values: 540p, 720p, 1080p
string
required
First frame image. Supports Base64-encoded images or image URLs. Only 1 image is supported. Supported formats: png, jpeg, jpg, webp. Image aspect ratio must be less than 1:4 or 4:1. Image size must not exceed 50 MB.
string
default:"bottom_left"
Watermark position. Default: bottom-left. This parameter has no effect if watermark is disabled.Possible values: top_left, top_right, bottom_right, bottom_left
array
required
Keyframe configuration array. Each task requires a minimum of 2 keyframes and a maximum of 9 keyframes.Array length: 2 - 9

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)