curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-pro-fl2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_frame_image": "https://example.com/snow-field.jpg",
  "last_frame_image": "https://example.com/spring-field.jpg"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-fl2v-002",
    "model_id": "vidu/viduq3-pro-fl2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-fl2v-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 Q3 Pro FL2V

[Core Function] Vidu Q3 Pro FL2V is a premium First-Last frame transition video model. [Strengths] It excels at generating highly detailed, cinematic, and logically consistent video transitions between a starting image and an ending image. [Best For] Highly recommended for: high-end commercial transitions, complex subject morphing, professional time-lapse effects, and cinematic storyboard completion. [Limitations] Do NOT use this model with only a single image; both a start and end frame are strictly required. [Routing] Use this by default when the user provides exactly two images (start and end) and wants a video bridging them. For faster but lower-quality results, use Q3 Turbo FL2V.

POST

vidu

viduq3-pro-fl2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-pro-fl2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_frame_image": "https://example.com/snow-field.jpg",
  "last_frame_image": "https://example.com/spring-field.jpg"
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-fl2v-002",
    "model_id": "vidu/viduq3-pro-fl2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-fl2v-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 Q3 first-last frame to video request. The model animates a seamless transition from first_frame_image to last_frame_image. Both images are required.

first_frame_image

string

required

Opening frame of the video (the scene that the animation starts from). Accepts a URL or base64 data URI.

Minimum string length: 1

Example:

"https://example.com/sunrise.jpg"

last_frame_image

string

required

Closing frame of the video (the scene that the animation ends at). Accepts a URL or base64 data URI.

Minimum string length: 1

Example:

"https://example.com/sunset.jpg"

prompt

string

Description of the transition between the two frames

Required string length: 1 - 5000

Example:

"A flower slowly blooms, petals unfurling in the warm morning light"

duration

integer

default:5

Video duration in seconds

Required range: 1 <= x <= 16

Example:

8

resolution

enum<string>

default:720p

Video resolution

Available options:

540p,

720p,

1080p

Example:

"1080p"

seed

integer

Random seed for reproducibility

Example:

2468

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

Viduq3 pro fast i2v Viduq3 pro i2v

Model API

Common API

File API

Vidu Q3 Pro FL2V

Authorizations

Body

Response