Vidu Q3-Mix - Generate Video (AI Model · By )

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q3-Mix (viduq3-mix)

viduq3-mix0 models support this endpoint

Vidu Q3 Mix is a specialized variant focused on multi-entity consistency. Instead of animating a single image, it takes 1–4 reference images and fuses them into a single cohesive video where every subject maintains its distinct identity throughout the clip.

Generate video

https://api.modelstream.ai

POST/v1/video/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

images*array

Upload 1-7 reference images; the model generates a subject-consistent video based on the subjects in them. Supports PNG, JPEG, JPG, WebP; pixels ≥128×128, aspect ratio between 1:4 and 4:1, each image ≤50MB.

RequiredExample Value: ["https://static.modelstream.ai/demo/vidu/viduq3-mix.png"]Value Range: 0 ≤ value ≤ 7

prompt*string

Text prompt describing the video scene and motion, max 2000 characters.

RequiredExample Value: The longship's hull cracks and collapses into the water, ending in a massive plume of sparks and steam upward. Flames engulf the dragon-prow head. The woman raises her fist in the air. Wind intensifies, her cloak snaps behind her like a banner. Smoke rolls across the cliff edge. The fjord water churns with reflected fire. Intense, dramatic, climactic.Placeholder: Describe the video content you want to generate...

duration?number

Video duration in seconds; viduq3-mix range 3-16 seconds, default 5.

Example Value: 5Value Range: 3 ≤ value ≤ 16step: 1

aspect_ratio?string

Video aspect ratio; viduq3-mix supports 16:9, 9:16, 1:1 (4:3 and 3:4 are q2-only). Default 16:9.

Example Value: 16:9

Enum/Options:

16:99:161:1

resolution?string

Video output resolution; viduq3-mix supports only 720p and 1080p (no 540p), default 720p.

Example Value: 720p

Enum/Options:

720p1080p

audio?boolean

Whether to use audio-video direct output. viduq3-mix supports synchronized audio; enabled by default. When off, outputs a silent video.

Example Value: true

seed?number

Random seed. Enter a fixed integer for reproducible results; leave empty or set to 0 for a random seed.

Placeholder: Leave empty or 0 for random seed

watermark?boolean

Whether to add a watermark (fixed AI-generated content marker) to the video. Disabled by default.

Example Value: false

wm_position?string

Watermark position: 1=top-left, 2=top-right, 3=bottom-right, 4=bottom-left. Effective only when watermark is enabled.

Example Value: 3

Enum/Options:

Top-left: 1Top-right: 2Bottom-right: 3Bottom-left: 4

wm_url?string

URL of a custom watermark image. Leave empty to use the default watermark. Effective only when watermark is enabled.

Placeholder: Custom watermark image URL (optional)

Response Parameters

application/json

200apiDocs.responses.successCreateVideoGenTask

task_id?string

Parameter description for Task Id

status?string

Parameter description for Status

400apiDocs.responses.badRequestParams

error?object

Parameter description for Error

message?string

Error Message

type?string

Error Type

param?string

Related Parameters

code?string

Error Code

curl -X POST "https://api.modelstream.ai/v1/video/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "viduq3-mix",
  "images": [
    "https://static.modelstream.ai/demo/vidu/viduq3-mix.png"
  ],
  "prompt": "The crystalline phoenix slowly opens its eyes, which glow with a soft golden warmth. It gently unfurls its wings, causing the iridescent glass feathers to shift and shimmer as liquid gold ripples across them. The floating embers and golden ash in the air drift upward in response to the wing movement, while the misty waterfall in the deep background continues to cascade down softly. 5-second video, high-fantasy, intricately detailed.",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "seed": 0,
  "audio": true,
  "watermark": false,
  "wm_position": 3
}'

{
  "task_id": "abcd1234efgh",
  "status": "queued"
}

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q3-Mix (viduq3-mix)

viduq3-mix0 models support this endpoint

Generate video

https://api.modelstream.ai

POST/v1/video/generations

Authentication

BearerAuth

AuthenticationBearer <token>

All API requests must be authenticated using a Bearer token in the Authorization header. Please ensure your API key is active.Authorization: Bearer sk-xxxxxx

Parameter Location: Header Param

Request Body

application/json

These parameters come from the selected model form_schema. Switching models updates this list and the request example.

images*array

RequiredExample Value: ["https://static.modelstream.ai/demo/vidu/viduq3-mix.png"]Value Range: 0 ≤ value ≤ 7

prompt*string

Text prompt describing the video scene and motion, max 2000 characters.

duration?number

Video duration in seconds; viduq3-mix range 3-16 seconds, default 5.

Example Value: 5Value Range: 3 ≤ value ≤ 16step: 1

aspect_ratio?string

Video aspect ratio; viduq3-mix supports 16:9, 9:16, 1:1 (4:3 and 3:4 are q2-only). Default 16:9.

Example Value: 16:9

Enum/Options:

16:99:161:1

resolution?string

Video output resolution; viduq3-mix supports only 720p and 1080p (no 540p), default 720p.

Example Value: 720p

Enum/Options:

720p1080p

audio?boolean

Whether to use audio-video direct output. viduq3-mix supports synchronized audio; enabled by default. When off, outputs a silent video.

Example Value: true

seed?number

Random seed. Enter a fixed integer for reproducible results; leave empty or set to 0 for a random seed.

Placeholder: Leave empty or 0 for random seed

watermark?boolean

Whether to add a watermark (fixed AI-generated content marker) to the video. Disabled by default.

Example Value: false

wm_position?string

Watermark position: 1=top-left, 2=top-right, 3=bottom-right, 4=bottom-left. Effective only when watermark is enabled.

Example Value: 3

Enum/Options:

Top-left: 1Top-right: 2Bottom-right: 3Bottom-left: 4

wm_url?string

URL of a custom watermark image. Leave empty to use the default watermark. Effective only when watermark is enabled.

Placeholder: Custom watermark image URL (optional)

Response Parameters

application/json

200apiDocs.responses.successCreateVideoGenTask

task_id?string

Parameter description for Task Id

status?string

Parameter description for Status

400apiDocs.responses.badRequestParams

error?object

Parameter description for Error

message?string

Error Message

type?string

Error Type

param?string

Related Parameters

code?string

Error Code

curl -X POST "https://api.modelstream.ai/v1/video/generations" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "viduq3-mix",
  "images": [
    "https://static.modelstream.ai/demo/vidu/viduq3-mix.png"
  ],
  "prompt": "The crystalline phoenix slowly opens its eyes, which glow with a soft golden warmth. It gently unfurls its wings, causing the iridescent glass feathers to shift and shimmer as liquid gold ripples across them. The floating embers and golden ash in the air drift upward in response to the wing movement, while the misty waterfall in the deep background continues to cascade down softly. 5-second video, high-fantasy, intricately detailed.",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "seed": 0,
  "audio": true,
  "watermark": false,
  "wm_position": 3
}'

{
  "task_id": "abcd1234efgh",
  "status": "queued"
}