Hailuo-2.3-Fast - Generate Video (AI Model · By )

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Hailuo-2.3-Fast

Hailuo-2.3-Fast0 models support this endpoint

Hailuo 2.3 Fast is a speed-optimized variant of MiniMax's Hailuo 2.3 video generation model. It is primarily oriented toward image-to-video workflows, taking a reference image with text prompts to animate it into video output. It retains the realistic motion, human physics, and character consistency of the standard Hailuo 2.3 while delivering roughly 2.5x faster generation and about half the cost, making trade-offs in model size and feature scope for rapid turnaround. It is suited for quick previews, prototyping, social clips, and large-scale batch production.

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.

image*string

Upload one image as the first frame. Hailuo-2.3-Fast supports image-to-video only. Supports JPG, JPEG, PNG, WebP, < 20MB, short side > 300px, aspect ratio between 2:5 and 5:2.

RequiredExample Value: https://static.modelstream.ai/UserUploads/image/20260611/1975c9b1ab8ba715f1af0b0acd5b3830.pngValue Range: 0 ≤ value ≤ 1

prompt?string

Text prompt describing motion and camera, max 2000 characters. Optional.

Example Value: The astronaut waved and the camera slowly moved up.Placeholder: Describe the motion and camera, up to 2000 characters (optional)...

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

fast_pretreatment?boolean

Shortens prompt-optimizer processing time. Only effective when an image is provided. Disabled by default.

Example Value: false

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-Fast",
  "image": {
    "imageUrl": "https://static.modelstream.ai/UserUploads/image/20260611/1975c9b1ab8ba715f1af0b0acd5b3830.png"
  },
  "prompt": "The astronaut waved and the camera slowly moved up.",
  "promptOptimizer": true,
  "fastPretreatment": false,
  "duration": 6,
  "resolution": "768p",
  "aigcWatermark": false
}'

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

API Documentation

API Reference

Videos

Generate Video

Supported Model Code

Loading models...

Hailuo-2.3-Fast

Hailuo-2.3-Fast0 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.

image*string

Upload one image as the first frame. Hailuo-2.3-Fast supports image-to-video only. Supports JPG, JPEG, PNG, WebP, < 20MB, short side > 300px, aspect ratio between 2:5 and 5:2.

RequiredExample Value: https://static.modelstream.ai/UserUploads/image/20260611/1975c9b1ab8ba715f1af0b0acd5b3830.pngValue Range: 0 ≤ value ≤ 1

prompt?string

Text prompt describing motion and camera, max 2000 characters. Optional.

Example Value: The astronaut waved and the camera slowly moved up.Placeholder: Describe the motion and camera, up to 2000 characters (optional)...

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

fast_pretreatment?boolean

Shortens prompt-optimizer processing time. Only effective when an image is provided. Disabled by default.

Example Value: false

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-Fast",
  "image": {
    "imageUrl": "https://static.modelstream.ai/UserUploads/image/20260611/1975c9b1ab8ba715f1af0b0acd5b3830.png"
  },
  "prompt": "The astronaut waved and the camera slowly moved up.",
  "promptOptimizer": true,
  "fastPretreatment": false,
  "duration": 6,
  "resolution": "768p",
  "aigcWatermark": false
}'

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