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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2-Turbo (viduq2-turbo)

viduq2-turbo0 models support this endpoint

Vidu Q2 Turbo provides a perfect balance of high-quality generation effects and rapid processing speed, ideal for fast-paced video creation.

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/viduq2-turbo_reference1.png

prompt?string

Example Value: The ninja holding the glowing katana slashes it forward, leaving a sharp red light trail. A sudden gust of wind blows a heavy swirl of cherry blossom petals across the screen. The paper lanterns below flicker as the camera pulls back slightly. 5-second video, dynamic anime style.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-Turbo 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-Turbo 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

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-turbo",
  "prompt": "Camera pans across a futuristic cyberpunk city with neon lights and flying cars.",
  "stype": "general",
  "duration": 5,
  "images": [
    "https://static.modelstream.ai/cover_img/nanobanana/nano_banan_pro.png"
  ],
  "is_rec": true,
  "audio": false,
  "audio_type": "All",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "720p",
    "bgm": true
  }
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2-Turbo (viduq2-turbo)

viduq2-turbo0 models support this endpoint

Vidu Q2 Turbo provides a perfect balance of high-quality generation effects and rapid processing speed, ideal for fast-paced video creation.

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/viduq2-turbo_reference1.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-Turbo 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-Turbo 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

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-turbo",
  "prompt": "Camera pans across a futuristic cyberpunk city with neon lights and flying cars.",
  "stype": "general",
  "duration": 5,
  "images": [
    "https://static.modelstream.ai/cover_img/nanobanana/nano_banan_pro.png"
  ],
  "is_rec": true,
  "audio": false,
  "audio_type": "All",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "720p",
    "bgm": true
  }
}'

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

Vidu Q2-Turbo - Generate Video (AI Model · By ) | ModelStream