curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-pro-t2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A pianist performing under a single spotlight on a dark stage, fingers dancing across the keys"
}
'

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

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' 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 T2V

[Core Function] Vidu Q3 Pro T2V is a premium cinematic text-to-video generation model. [Strengths] It excels at generating top-tier, realistic videos from text with support for advanced multi-shot ‘smart cuts’, complex physics, and simultaneous audio-visual generation. [Best For] Highly recommended for: cinematic storytelling, professional advertising, short films, and high-fidelity concept visualizations. [Limitations] Do NOT use this model if the user is looking for an instant, low-latency preview, as generation takes longer. It does not support automatic BGM addition. [Routing] Use this model by default for high-quality text-to-video requests. If the user specifically asks for ‘fast’ or ‘quick’ generation, switch to the Q3 Turbo T2V model.

POST

vidu

viduq3-pro-t2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-pro-t2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A pianist performing under a single spotlight on a dark stage, fingers dancing across the keys"
}
'

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

{
  "code": 400,
  "message": "Invalid parameters: parameter 'prompt' 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 Turbo and Pro text-to-video request.

prompt

string

required

Video description text

Required string length: 1 - 5000

Example:

"A golden retriever running through a sun-drenched meadow of wildflowers"

duration

integer

default:5

Video duration in seconds

Required range: 1 <= x <= 16

Example:

8

aspect_ratio

enum<string>

default:16:9

Video aspect ratio

Available options:

16:9,

9:16,

1:1,

3:4,

4:3

Example:

"16:9"

resolution

enum<string>

default:720p

Video resolution

Available options:

540p,

720p,

1080p

Example:

"1080p"

seed

integer

Random seed for reproducibility

Example:

42

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 i2v Viduq3 r2v

Model API

Common API

File API

Vidu Q3 Pro T2V

Authorizations

Body

Response