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

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-i2v-001",
    "model_id": "vidu/viduq3-pro-fast-i2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-i2v-001"
    }
  }
}

{
  "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 Fast I2V

[Core Function] Vidu Q3 Pro Fast I2V is a high-speed Image-to-Video generation model. [Strengths] It excels at generating smooth, physically accurate continuous motion from a single starting frame with extremely low latency. [Best For] Highly recommended for: fast prototyping, short dynamic product showcases, quick cinematic transitions, and scenarios where generation speed is prioritized over maximum detail. [Limitations] Do NOT use this model if the user requires 4K resolution, complex multi-character interactions, or highly stylized 2D anime deformations. It only supports 720p/1080p resolutions. [Routing] Choose this ‘Fast’ model when the user emphasizes ‘quick’, ‘fast’, or needs immediate results. If the user demands ultimate cinematic quality, choose the standard Q3 Pro I2V model instead.

POST

vidu

viduq3-pro-fast-i2v

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

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-i2v-001",
    "model_id": "vidu/viduq3-pro-fast-i2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-i2v-001"
    }
  }
}

{
  "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 Pro Fast I2V request. Resolution limited to 720p and 1080p.

first_frame_image

string

required

Starting frame image URL or base64 data URI

Minimum string length: 1

Example:

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

prompt

string

Motion description for the generated video

Required string length: 1 - 5000

Example:

"Camera slowly pans right revealing a vast mountain range"

duration

integer

default:5

Video duration in seconds

Required range: 1 <= x <= 16

Example:

8

resolution

enum<string>

default:720p

Video resolution (720p or 1080p only)

Available options:

720p,

1080p

Example:

"1080p"

seed

integer

Random seed for reproducibility

Example:

7890

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 mix r2v Viduq3 pro fl2v

Model API

Common API

File API

Vidu Q3 Pro Fast I2V

Authorizations

Body

Response