curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-turbo-r2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A superhero leaps from a rooftop, cape billowing dramatically against the city skyline",
  "reference_images": [
    "https://example.com/hero.jpg"
  ]
}
'

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

[Core Function] Vidu Q3 Turbo R2V is a fast reference-to-video generation model. [Strengths] It excels at quickly generating dynamic videos based on a text prompt while preserving the identity of the subjects from provided reference images. [Best For] Highly recommended for: rapid character animation, quick conceptual mockups with specific subjects, and fast social media content featuring consistent characters. [Limitations] Do NOT use this model if you need the absolute highest cinematic quality or if you just want to animate an image directly without a text prompt. [Routing] Choose this model for fast generation of a character performing actions based on a text prompt. For better quality, use Q3 R2V or Q3 Mix R2V.

POST

vidu

viduq3-turbo-r2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-turbo-r2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A superhero leaps from a rooftop, cape billowing dramatically against the city skyline",
  "reference_images": [
    "https://example.com/hero.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-r2v-002",
    "model_id": "vidu/viduq3-turbo-r2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-r2v-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 Turbo and standard R2V request. Duration minimum 3s.

prompt

string

required

Video description text

Required string length: 1 - 5000

Example:

"A superhero leaps from a rooftop, cape billowing dramatically"

reference_images

string[]

required

Portrait or subject images (1-7) whose appearance will be preserved in the generated video. Accepts URLs or base64 data URIs.

Required array length: 1 - 7 elements

Minimum string length: 1

Example:

["https://example.com/hero.jpg"]

duration

integer

default:5

Video duration in seconds (minimum 3)

Required range: 3 <= x <= 16

Example:

6

aspect_ratio

enum<string>

default:16:9

Video aspect ratio

Available options:

16:9,

9:16,

1:1

Example:

"16:9"

resolution

enum<string>

default:720p

Video resolution

Available options:

540p,

720p,

1080p

Example:

"1080p"

seed

integer

Random seed for reproducibility

Example:

2222

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 turbo i2v Viduq3 turbo t2v

Model API

Common API

File API

Vidu Q3 Turbo R2V

Authorizations

Body

Response