curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-mix-r2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A majestic wolf running across a snowy tundra under the northern lights",
  "reference_images": [
    "https://example.com/wolf.jpg"
  ]
}
'

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

[Core Function] Vidu Q3 Mix R2V is a mixed-style reference-to-video generation model. [Strengths] It excels at generating highly consistent character videos by synthesizing and blending features from multiple reference images (up to 7) based on a text prompt. [Best For] Highly recommended for: maintaining strict character consistency across different styles, generating videos of a specific subject in entirely new environments, and blending concepts from multiple reference images. [Limitations] Do NOT use this model if you just want to animate a single image as is (use standard I2V). This model focuses on extracting character/style features and generating new content. [Routing] Use this when the user provides reference images of a character/subject and wants a video of them doing a specific new action from a text prompt, prioritizing mixed-style consistency.

POST

vidu

viduq3-mix-r2v

curl --request POST \
  --url https://api.modellix.ai/api/v1/vidu/viduq3-mix-r2v \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "A majestic wolf running across a snowy tundra under the northern lights",
  "reference_images": [
    "https://example.com/wolf.jpg"
  ]
}
'

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-vidu-r2v-001",
    "model_id": "vidu/viduq3-mix-r2v",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-vidu-r2v-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 Mix R2V request. Resolution limited to 720p/1080p. Aspect ratio limited to 16:9/9:16/1:1. Duration range 1-16s.

prompt

string

required

Video description text

Required string length: 1 - 5000

Example:

"A majestic wolf running across a snowy tundra under the northern lights"

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/wolf.jpg"]

duration

integer

default:5

Video duration in seconds

Required range: 1 <= x <= 16

Example:

10

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 (720p or 1080p only)

Available options:

720p,

1080p

Example:

"1080p"

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 drama Viduq3 pro fast i2v

Model API

Common API

File API

Vidu Q3 Mix R2V

Authorizations

Body

Response