curl --request POST \
--url https://api.modellix.ai/api/v1/vidu/viduq2-pro-multi-frame \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"start_image": "https://example.com/martial-arts-1.jpg",
"key_images": [
"https://example.com/martial-arts-2.jpg"
]
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-vidu-mf-002",
"model_id": "vidu/viduq2-pro-multi-frame",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-vidu-mf-002"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'first_frame_image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Vidu Q2 Pro Multi Frame
[Core Function] Vidu Q2 Pro Multi-Frame is a sequence-based animation model. [Strengths] It excels at creating continuous, high-quality animation by interpolating through a provided sequence of keyframes (up to 9 images). [Best For] Highly recommended for: complex motion control, precise character posing sequences, and animating detailed storyboards where intermediate states must be strictly followed. [Limitations] Do NOT use this model if you only have one or two images (use standard I2V or FL2V instead). It requires a start image and a list of key images. [Routing] Use this exclusively when the user provides a sequence of 3 to 9 specific frames and wants them animated in order.
curl --request POST \
--url https://api.modellix.ai/api/v1/vidu/viduq2-pro-multi-frame \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"start_image": "https://example.com/martial-arts-1.jpg",
"key_images": [
"https://example.com/martial-arts-2.jpg"
]
}
'{
"code": 0,
"message": "success",
"data": {
"status": "pending",
"task_id": "task-vidu-mf-002",
"model_id": "vidu/viduq2-pro-multi-frame",
"get_result": {
"method": "GET",
"url": "https://api.modellix.ai/api/v1/tasks/task-vidu-mf-002"
}
}
}{
"code": 400,
"message": "Invalid parameters: parameter 'first_frame_image' is required"
}{
"code": 401,
"message": "Authentication failed: invalid API key"
}{
"code": 429,
"message": "Rate limit exceeded: 100 requests per minute, retry after 60 seconds"
}{
"code": 500,
"message": "Internal server error"
}Authorizations
API Key authentication. Format: Bearer YOUR_API_KEY.
Body
Vidu Q2 multi-frame animation request. Supports up to 9 total frames (1 start + up to 8 key images).
First frame of the animation. Accepts a URL or base64 data URI.
1"https://example.com/pose-1.jpg"
Subsequent frames to animate through (1-8 images). Combined with start_image, the total frame count must be 2-9. Accepts URLs or base64 data URIs.
1 - 8 elements1[
"https://example.com/pose-2.jpg",
"https://example.com/pose-3.jpg"
]
Video resolution
540p, 720p, 1080p "1080p"