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