Vidu Q2-Pro - Generate Video (AI Model · By )

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2-Pro (viduq2-pro)

viduq2-pro0 models support this endpoint

Vidu Q2 Pro is a next-generation model delivering excellent overall performance, high-fidelity image-to-video generation, and precise audio-visual synchronization.

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.

image*string

Image used as the start frame of the generated video. Supports PNG, JPEG, JPG, WebP; aspect ratio between 1:4 and 4:1; each image ≤50MB.

RequiredExample Value: https://static.modelstream.ai/demo/vidu/Vidu%20Q2-pro_reference.png

prompt?string

Example Value: 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.Placeholder: Describe the video you want to generate...

stype?string

Generation style. general: general/realistic style; anime: anime style. Default general.

Example Value: general

Enum/Options:

General: generalAnime: anime

is_rec?boolean

System will automatically generate and apply a suitable prompt (consumes extra credits)

Example Value: false

resolution?string

Video output resolution; Vidu Q2-Pro supports 540p, 720p, 1080p, default 720p.

Example Value: 720p

Enum/Options:

540P SD: 540p720P HD: 720p1080P FHD: 1080p

duration?number

Video duration in seconds; Vidu Q2-Pro range 1-10 seconds, default 5.

Example Value: 5Value Range: 1 ≤ value ≤ 10step: 1

audio?boolean

Whether to generate video with sound effects/vocals. Disabled by default. Off-peak mode is unavailable when this is off.

Example Value: false

audio_type?string

Audio type; effective only when 'Generate Audio' is on, default All.

Example Value: All

Enum/Options:

All (Effects + Vocals): AllSpeech Only: Speech_onlySound Effect Only: Sound-effect_only

bgm?boolean

Example Value: false

off_peak?boolean

Consumes fewer credits, but generates within 48 hours

Example Value: false

seed?number

Example Value: 0Value Range: 0 ≤ value ≤ 99999999

movement_amplitude?string

Control the intensity of motion in the video. Default auto.

Example Value: auto

Enum/Options:

Auto: autoSmall: smallMedium: mediumLarge: large

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": "viduq2-pro",
  "prompt": "A cinematic shot of a person walking in the rain under a glowing street lamp.",
  "stype": "general",
  "duration": 5,
  "images": [
    "https://r2-assets.modelstream.ai/previews/rain_start_frame.jpg"
  ],
  "is_rec": false,
  "audio": true,
  "audio_type": "Sound-effect_only",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "1080p",
    "bgm": true,
    "movement_amplitude": "auto"
  }
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2-Pro (viduq2-pro)

viduq2-pro0 models support this endpoint

Vidu Q2 Pro is a next-generation model delivering excellent overall performance, high-fidelity image-to-video generation, and precise audio-visual synchronization.

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.

image*string

Image used as the start frame of the generated video. Supports PNG, JPEG, JPG, WebP; aspect ratio between 1:4 and 4:1; each image ≤50MB.

RequiredExample Value: https://static.modelstream.ai/demo/vidu/Vidu%20Q2-pro_reference.png

prompt?string

stype?string

Generation style. general: general/realistic style; anime: anime style. Default general.

Example Value: general

Enum/Options:

General: generalAnime: anime

is_rec?boolean

System will automatically generate and apply a suitable prompt (consumes extra credits)

Example Value: false

resolution?string

Video output resolution; Vidu Q2-Pro supports 540p, 720p, 1080p, default 720p.

Example Value: 720p

Enum/Options:

540P SD: 540p720P HD: 720p1080P FHD: 1080p

duration?number

Video duration in seconds; Vidu Q2-Pro range 1-10 seconds, default 5.

Example Value: 5Value Range: 1 ≤ value ≤ 10step: 1

audio?boolean

Whether to generate video with sound effects/vocals. Disabled by default. Off-peak mode is unavailable when this is off.

Example Value: false

audio_type?string

Audio type; effective only when 'Generate Audio' is on, default All.

Example Value: All

Enum/Options:

All (Effects + Vocals): AllSpeech Only: Speech_onlySound Effect Only: Sound-effect_only

bgm?boolean

Example Value: false

off_peak?boolean

Consumes fewer credits, but generates within 48 hours

Example Value: false

seed?number

Example Value: 0Value Range: 0 ≤ value ≤ 99999999

movement_amplitude?string

Control the intensity of motion in the video. Default auto.

Example Value: auto

Enum/Options:

Auto: autoSmall: smallMedium: mediumLarge: large

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": "viduq2-pro",
  "prompt": "A cinematic shot of a person walking in the rain under a glowing street lamp.",
  "stype": "general",
  "duration": 5,
  "images": [
    "https://r2-assets.modelstream.ai/previews/rain_start_frame.jpg"
  ],
  "is_rec": false,
  "audio": true,
  "audio_type": "Sound-effect_only",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "1080p",
    "bgm": true,
    "movement_amplitude": "auto"
  }
}'

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