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.

POST

vidu

viduq2-pro-multi-frame

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

Authorization

string

header

required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Vidu Q2 multi-frame animation request. Supports up to 9 total frames (1 start + up to 8 key images).

start_image

string

required

First frame of the animation. Accepts a URL or base64 data URI.

Minimum string length: 1

Example:

"https://example.com/pose-1.jpg"

key_images

string[]

required

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.

Required array length: 1 - 8 elements

Minimum string length: 1

Example:

[
  "https://example.com/pose-2.jpg",
  "https://example.com/pose-3.jpg"
]

resolution

enum<string>

default:720p

Video resolution

Available options:

540p,

720p,

1080p

Example:

"1080p"

Response

Task submitted successfully

code

integer

required

Response code, 0 indicates success

Example:

0

message

string

required

Response message

Example:

"success"

data

object

required

Detailed data about the submitted asynchronous task.

Show child attributes

Viduq2 pro digital human Viduq2 turbo digital human

Model API

Common API

File API

Vidu Q2 Pro Multi-Frame

Authorizations

Body

Response