Vidu Q2 - Generate Video (AI Model · By )

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2 (viduq2)

viduq20 models support this endpoint

Vidu Q2 offers efficient image-to-video generation with stable quality, fast processing speeds, and high cost-effectiveness.

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.

prompt*string

Text description, max 2000 characters. Vidu Q2 text-to-video generates a video directly from the prompt.

RequiredExample Value: A vintage red sports car driving down a winding coastal highway at sunset. The camera is positioned low, tracking alongside the car as the ocean waves crash against the cliffs in the background. Warm golden hour light glints off the car's polished chrome and glossy paint. 5-second video, photorealistic, cinematic camera movement.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

duration?number

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

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

aspect_ratio?string

Video aspect ratio; Vidu Q2 supports 16:9, 9:16, 1:1, 4:3, 3:4. Default 16:9.

Example Value: 16:9

Enum/Options:

16:9 Landscape: 16:99:16 Portrait: 9:163:44:31:1 Square: 1:1

resolution?string

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

Example Value: 720p

Enum/Options:

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

bgm?boolean

System automatically adds suitable background music. Note: BGM is not supported for 9s or 10s videos.

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",
  "prompt": "The astronaut waved and the camera moved up.",
  "stype": "general",
  "duration": 5,
  "aspect_ratio": "16:9",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "1080p",
    "bgm": false
  }
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q2 (viduq2)

viduq20 models support this endpoint

Vidu Q2 offers efficient image-to-video generation with stable quality, fast processing speeds, and high cost-effectiveness.

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.

prompt*string

Text description, max 2000 characters. Vidu Q2 text-to-video generates a video directly from the prompt.

stype?string

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

Example Value: general

Enum/Options:

General: generalAnime: anime

duration?number

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

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

aspect_ratio?string

Video aspect ratio; Vidu Q2 supports 16:9, 9:16, 1:1, 4:3, 3:4. Default 16:9.

Example Value: 16:9

Enum/Options:

16:9 Landscape: 16:99:16 Portrait: 9:163:44:31:1 Square: 1:1

resolution?string

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

Example Value: 720p

Enum/Options:

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

bgm?boolean

System automatically adds suitable background music. Note: BGM is not supported for 9s or 10s videos.

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",
  "prompt": "The astronaut waved and the camera moved up.",
  "stype": "general",
  "duration": 5,
  "aspect_ratio": "16:9",
  "off_peak": false,
  "metadata": {
    "seed": 0,
    "resolution": "1080p",
    "bgm": false
  }
}'

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

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