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...
H
Hailuo-2.3
Hailuo-2.30 models support this endpoint

Hailuo 2.3 is a video generation model from MiniMax. It accepts text prompts and reference images as input and generates video output, supporting both text-to-video and image-to-video workflows. It is suited for creative content production, cinematic scene generation, and character animation, with a focus on realistic motion and expressive character rendering.

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. Text to Video: prompt only. Image to Video: upload one image as the first frame. Hailuo-2.3 supports both.

prompt*string

Text prompt, max 2000 characters. Required in Text-to-Video mode, optional in Image-to-Video mode.

RequiredExample Value: A cinematic shot of a corgi running along a sunset beach, fur blowing in the wind.Placeholder: Describe the video you want to generate, up to 2000 characters...
duration?string

Video duration in seconds, 6 or 10, default 6. Only 6 seconds is supported at 1080p.

Example Value: 6
Enum/Options:
6s: 610s: 10
resolution?string

Video output resolution, 768p or 1080p, default 768p. 1080p supports only the 6-second duration.

Example Value: 768p
Enum/Options:
768p1080p
prompt_optimizer?boolean

Whether to automatically optimize the prompt. When on, the system rewrites the prompt to improve results. Enabled by default.

Example Value: true
aigc_watermark?boolean

Whether to add an AIGC watermark to the generated video. 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": "Hailuo-2.3",
  "prompt": "A cinematic shot of a corgi running along a sunset beach, fur blowing in the wind.",
  "promptOptimizer": true,
  "duration": 6,
  "resolution": "768p",
  "aigcWatermark": false
}'
{
  "task_id": "abcd1234efgh",
  "status": "queued"
}