ModelStream LogoModelStream Logo
Models
Video API
Image API
Chat API
Audio API
Studio
Pricing
Docs
Menu
IntroductionQuickstartAPI KeysUse with Hermes AgentUse with OpenClaw
Model ListBilling Guide
ModelStream

Video API

  • Seedance 2.0
  • Happyhorse 1.0
  • Vidu Q3
  • Kling V3.0
  • Veo 3.1
  • Wan 2.7
  • More Video Models →

Image API

  • GPT Image 2
  • Nano Banana 2
  • Seedream 5.0
  • Imagen 4
  • Qwen Image 2.0
  • Z-Image Turbo
  • More Image Models →

Audio API

  • Suno Music
  • Qwen3 TTS Flash
  • More Audio Models →

Chat API

  • GLM-5.2
  • Claude Opus 4.8
  • Gemini 3.5 Flash
  • Qwen 3.7 Max
  • GPT 5.5
  • More Chat Models →

About Us

  • Privacy Policy
  • Terms of Service
  • Support
  • Enterprise

© 2026 ModelStream Inc. All rights reserved.

API Documentation
API Reference
Videos
Generate Video

Generate Video

Loading models...
V
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"
}