Hailuo-02 - Generate Video (AI Model · By )

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Hailuo-02

Hailuo-020 models support this endpoint

Hailuo 02 is a cinematic 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. Built on MiniMax's NCR (Noise-aware Compute Redistribution) architecture, it delivers high-resolution output up to 1080p (with 512p and 768p options) and camera-aware generation, with a focus on realistic physics, frame consistency, and film-like visual fidelity. It is suited for cinematic scene generation, creative content production, and physics-driven motion such as acrobatics and complex action.

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: one image as the first frame. First-Last Frame: upload a first and last frame for a transition video. Hailuo-02 supports all three.

prompt*string

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

RequiredExample Value: A futuristic city at dusk with flying cars weaving between neon skyscrapers, cinematic aerial shot.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-02",
  "prompt": "A futuristic city at dusk with flying cars weaving between neon skyscrapers, cinematic aerial shot.",
  "promptOptimizer": true,
  "duration": 6,
  "resolution": "768p",
  "aigcWatermark": false
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Hailuo-02

Hailuo-020 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

prompt*string

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

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-02",
  "prompt": "A futuristic city at dusk with flying cars weaving between neon skyscrapers, cinematic aerial shot.",
  "promptOptimizer": true,
  "duration": 6,
  "resolution": "768p",
  "aigcWatermark": false
}'

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