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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q3-Pro (viduq3-pro)

viduq3-pro0 models support this endpoint

Vidu Q3 Pro generates cinematic image-to-video content with native audio-visual synchronization and storyboard-level scene control. Built on Vidu's Q3 architecture, it transforms a single reference image into up to 16 seconds of high-fidelity video at 1080p resolution, complete with dialogue, sound effects, and physically coherent motion. Designed for creators who prioritize quality and creative control over speed.

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.

Generation Mode

Choose the generation mode. Single Image: upload one image as the first frame. Head-tail Frames: upload a first and last frame to generate the transition video between them. Only one mode can be used at a time.

image*string

[Single Image mode] Upload an image as the starting frame of the video. Supports JPG, JPEG, PNG formats, max 50MB, aspect ratio must be between 1:4 and 4:1.

RequiredExample Value: https://static.modelstream.ai/demo/vidu/viduq3-pro.png

prompt*string

Text prompt describing the video scene and motion, max 5000 characters. When 'Recommended prompt optimization' is enabled, the system rewrites this prompt automatically.

RequiredExample Value: The woman gently pushes the glowing krathong forward onto the water. Lanterns slowly drift upward into the night sky. Soft ripples spread across the dark river surface. Candlelight flickers on her face. Her silk dress sways slightly in the warm breeze. Cinematic, slow motion.Placeholder: Describe the video content you want to generate...

duration?number

Video duration in seconds, range 1-16 seconds.

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

resolution?string

Video output resolution. Options: 540p, 720p, 1080p.

Example Value: 720p

Enum/Options:

540p720p1080p

audio?boolean

Enable integrated audio-video direct output, producing video with sound. Enabled by default. Off-peak mode is unavailable when this is off.

Example Value: true

is_rec?boolean

Whether to use recommended prompt optimization. When enabled, the system optimizes the prompt automatically and costs an additional 10 credits per task. Disabled by default.

Example Value: false

seed?number

Random seed value. Set a fixed value for reproducible results, leave empty for a random seed.

Example Value: 0Placeholder: Leave empty for random seed

off_peak?boolean

Off-peak generation mode lowers task priority, extends processing time (up to 18 hours), and offers better pricing. Available only when 'Generate Audio' is enabled. Disabled by default.

Example Value: false

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-pro",
  "image": {
    "imageUrl": "https://static.modelstream.ai/demo/vidu/viduq3-pro.png"
  },
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 0,
  "resolution": "1080p",
  "audio": true,
  "isRec": false,
  "offPeak": false
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Vidu Q3-Pro (viduq3-pro)

viduq3-pro0 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.

Generation Mode

image*string

[Single Image mode] Upload an image as the starting frame of the video. Supports JPG, JPEG, PNG formats, max 50MB, aspect ratio must be between 1:4 and 4:1.

RequiredExample Value: https://static.modelstream.ai/demo/vidu/viduq3-pro.png

prompt*string

Text prompt describing the video scene and motion, max 5000 characters. When 'Recommended prompt optimization' is enabled, the system rewrites this prompt automatically.

duration?number

Video duration in seconds, range 1-16 seconds.

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

resolution?string

Video output resolution. Options: 540p, 720p, 1080p.

Example Value: 720p

Enum/Options:

540p720p1080p

audio?boolean

Enable integrated audio-video direct output, producing video with sound. Enabled by default. Off-peak mode is unavailable when this is off.

Example Value: true

is_rec?boolean

Whether to use recommended prompt optimization. When enabled, the system optimizes the prompt automatically and costs an additional 10 credits per task. Disabled by default.

Example Value: false

seed?number

Random seed value. Set a fixed value for reproducible results, leave empty for a random seed.

Example Value: 0Placeholder: Leave empty for random seed

off_peak?boolean

Off-peak generation mode lowers task priority, extends processing time (up to 18 hours), and offers better pricing. Available only when 'Generate Audio' is enabled. Disabled by default.

Example Value: false

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-pro",
  "image": {
    "imageUrl": "https://static.modelstream.ai/demo/vidu/viduq3-pro.png"
  },
  "prompt": "The astronaut waved and the camera moved up.",
  "duration": 5,
  "seed": 0,
  "resolution": "1080p",
  "audio": true,
  "isRec": false,
  "offPeak": false
}'

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

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