MiniMaxMediumHigh

MiniMax Hailuo 2.3 Fast

Lower-latency version of Hailuo 2.3 optimized for faster generation while maintaining good quality for human motion videos.

285 credits

per video

Faster generation than Hailuo 2.3

Good human motion quality

Character consistency

Image-to-video support

Cost-effective option

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txt

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/hailuo-2.3-fast",
  "input": {
    "prompt": "A businessman adjusting his tie and looking at the camera with a confident smile, office background, professional lighting",
    "duration": "3",
    "aspect_ratio": "16:9"
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text description of the video to generate
`image_url`	string	No	-	Starting image URL for image-to-video
`duration`	integer	No	6	Video duration in seconds (3 or 6) 36
`aspect_ratio`	string	No	16:9	Output aspect ratio 16:99:161:1

How to Provide File Input

There are 3 ways to provide files for the image_url parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=minimax/hailuo-2.3-fast" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image_url=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "minimax/hailuo-2.3-fast",
  "input": {
    "prompt": "your prompt here",
    "image_url": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Quick Character Test

Fast character motion test

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "minimax/hailuo-2.3-fast",
  "input": {
    "prompt": "A businessman adjusting his tie and looking at the camera with a confident smile, office background, professional lighting",
    "duration": "3",
    "aspect_ratio": "16:9"
  }
}'