MiniMax

Modes: video · audio · text · Models: 19

Vendor: MiniMax · Official API docs: MiniMax Platform — Video Generation

MiniMax provides MiniMax H3 (formerly Hailuo 03) for text-to-video and image-to-video at up to 2K, with start/end frames plus image, video, and audio references. The catalog also includes MiniMax H3 Max, the Hailuo 2.3 family, and MiniMax Music v2 for prompt-driven music with vocals.

Models

id	Name	Input type
`hailuo-2.3`	Hailuo 2.3	`t2v`
`hailuo-2.3-pro`	Hailuo 2.3 Pro	`t2v`
`hailuo-2.3-fast`	Hailuo 2.3 Fast	`i2v`
`hailuo-2.3-fast-pro`	Hailuo 2.3 Fast Pro	`i2v`
`minimax-h3`	MiniMax H3	`t2v`
`minimax-h3-highspeed`	MiniMax H3 Highspeed	`t2v`
`minimax-h3-lite`	MiniMax H3 Lite	`t2v`
`minimax-music-v2`	MiniMax Music v2	`music`
`minimax-music-v3`	MiniMax Music v3	`music`
`minimax-h3-max`	MiniMax H3 Max	`t2v`
`minimax-h3-max-turbo`	MiniMax H3 Max Turbo	`t2v`
`minimax-h3-max-camera-controls`	MiniMax H3 Max Camera Controls	`i2v`
`minimax-h3-max-lip-sync`	MiniMax H3 Max Lip Sync	`i2v`
`minimax-h3-max-extend`	MiniMax H3 Max Extend	`v2v`
`minimax-h3-max-relight`	MiniMax H3 Max Relight	`v2v`
`minimax-h3-max-recast`	MiniMax H3 Max Recast	`v2v`
`minimax-m3`	MiniMax M3	`i2t`
`minimax-m3.1-flash`	MiniMax M3.1 Flash	`i2t`
`minimax-h3-context-ir`	MiniMax H3 Context IR	`v2t`

CLI

bash

# text-to-video with a camera directive
gen-ai generate -m hailuo-2.3 \
  -p "a cat walks forward through a neon alley at night [Push in]" \
  -d 10

# image-to-video from a start frame (Fast variant)
gen-ai generate -m hailuo-2.3-fast -p "she turns and smiles" -i ./frame.png -d 6

# MiniMax H3 with a start frame
gen-ai generate -m minimax-h3 -p "the camera circles the subject" \
  --start-frame ./frame.png -d 10

# music with vocals
gen-ai generate -m minimax-music-v2 \
  -p "upbeat indie pop with bright guitars and an anthemic chorus, female vocals"

MCP

json

{ "name": "picsart_generate",
  "arguments": {
    "model": "hailuo-2.3",
    "prompt": "a cat walks forward through a neon alley at night [Push in]",
    "duration": 10
  } }

json

{ "name": "picsart_generate",
  "arguments": {
    "model": "minimax-music-v2",
    "prompt": "upbeat indie pop with bright guitars and an anthemic chorus, female vocals"
  } }

Parameters

Full parameter surface for every model, sourced from gen-ai models info <id> --json. CLI flags show the primary short form; the canonical --kebab-case long form always works too.

`hailuo-2.3` — Hailuo 2.3

Try hailuo-2.3 in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`enhancePrompt`	`--enhance-prompt`	boolean	`true` · `false` (default `true`)
`duration`	`-d`	enum	`6` · `10` (default `6`)
`imageUrls`	`-i`	file	image (up to 1)

`hailuo-2.3-pro` — Hailuo 2.3 Pro

Try hailuo-2.3-pro in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`enhancePrompt`	`--enhance-prompt`	boolean	`true` · `false` (default `true`)
`imageUrls`	`-i`	file	image (up to 1)

`hailuo-2.3-fast` — Hailuo 2.3 Fast

Try hailuo-2.3-fast in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`enhancePrompt`	`--enhance-prompt`	boolean	`true` · `false` (default `true`)
`duration`	`-d`	enum	`6` · `10` (default `6`)
`imageUrls`	`-i`	file	required image (up to 1)

`hailuo-2.3-fast-pro` — Hailuo 2.3 Fast Pro

Try hailuo-2.3-fast-pro in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`enhancePrompt`	`--enhance-prompt`	boolean	`true` · `false` (default `true`)
`imageUrls`	`-i`	file	required image (up to 1)

`minimax-h3` — MiniMax H3

Try minimax-h3 in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤7000 chars)
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`imageUrls`	`-i`	file	image (up to 9)
`videoUrls`	`--video-urls`	file	video (up to 3)
`audioUrls`	`--audio-urls`	file	audio (up to 3)
`resolution`	`-r`	enum	`768P` · `2K` (default `2K`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `adaptive`)

`minimax-h3-highspeed` — MiniMax H3 Highspeed

Try minimax-h3-highspeed in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤7000 chars)
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`imageUrls`	`-i`	file	image (up to 9)
`videoUrls`	`--video-urls`	file	video (up to 3)
`audioUrls`	`--audio-urls`	file	audio (up to 3)
`resolution`	`-r`	enum	`480P` · `768P` (default `768P`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `adaptive`)

`minimax-h3-lite` — MiniMax H3 Lite

Try minimax-h3-lite in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤7000 chars)
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`imageUrls`	`-i`	file	image (up to 9)
`videoUrls`	`--video-urls`	file	video (up to 3)
`audioUrls`	`--audio-urls`	file	audio (up to 3)
`resolution`	`-r`	enum	`480P` · `768P` (default `768P`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `16:9`)

`minimax-music-v2` — MiniMax Music v2

Try minimax-music-v2 in Playground ↗

Input type: music

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤2000 chars)
`lyricsPrompt`	`--lyrics-prompt`	text	lyrics, or a description of the lyrical theme (≤2000 chars, min 10)
`lyricsOptimizer`	`--lyrics-optimizer`	boolean	`true` · `false` (default `false`)
`isInstrumental`	`--is-instrumental`	boolean	`true` · `false` (default `false`)
`outputFormat`	`--output-format`	enum	`url` · `hex` (default `url`)

Notes: Pro variants omit duration (fixed 6s at 1080p); 10s is available at 768p only. On the Fast image-to-video models imageUrls is required.

`minimax-music-v3` — MiniMax Music v3

Try minimax-music-v3 in Playground ↗

Input type: music

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤2000 chars)
`lyricsPrompt`	`--lyrics-prompt`	text	free text (≤2000 chars)
`lyricsOptimizer`	`--lyrics-optimizer`	boolean	`true` · `false` (default `false`)
`isInstrumental`	`--is-instrumental`	boolean	`true` · `false` (default `false`)
`sampleRate`	`--sample-rate`	enum	`16000` · `24000` · `32000` · `44100` (default `44100`)
`bitrate`	`--bitrate`	enum	`32000` · `64000` · `128000` · `256000` (default `256000`)
`format`	`--format`	enum	`mp3` · `wav` · `pcm` (default `mp3`)

`minimax-h3-max` — MiniMax H3 Max

Try minimax-h3-max in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤50000 chars)
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`imageUrls`	`-i`	file	image (up to 9)
`videoUrls`	`--video-urls`	file	video (up to 3)
`audioUrls`	`--audio-urls`	file	audio (up to 3)
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` (default `768p`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `16:9`)
`promptExpansionMode`	`--prompt-expansion-mode`	enum	`balanced` · `quality` (default `balanced`)
`seed`	`--seed`	range	`-1`–`2147483647` (default `-1`)
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-h3-max-turbo` — MiniMax H3 Max Turbo

Try minimax-h3-max-turbo in Playground ↗

Input type: t2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required (≤50000 chars)
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` (default `768p`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `16:9`)
`promptExpansionMode`	`--prompt-expansion-mode`	enum	`balanced` · `quality` (default `balanced`)
`seed`	`--seed`	range	`-1`–`2147483647` (default `-1`)
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-h3-max-camera-controls` — MiniMax H3 Max Camera Controls

Try minimax-h3-max-camera-controls in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	free text (≤50000 chars)
`startFrame`	`--start-frame`	file	required image
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` (default `480p`)
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`cameraTrajectory`	`--camera-trajectory-time` · `--camera-trajectory-azimuth` · `--camera-trajectory-elevation` · `--camera-trajectory-distance`	object[]	`{time, azimuth, elevation, distance}`
`promptExpansionMode`	`--prompt-expansion-mode`	enum	`balanced` · `quality` (default `balanced`)
`seed`	`--seed`	range	`-1`–`2147483647` (default `-1`)
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-h3-max-lip-sync` — MiniMax H3 Max Lip Sync

Try minimax-h3-max-lip-sync in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
`startFrame`	`--start-frame`	file	required image
`audioUrl`	`-a`	file	required audio
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` · `2k` (default `768p`)
`enableTranscription`	`--enable-transcription`	boolean	`true` · `false` (default `false`)
`seed`	`--seed`	range	`-1`–`2147483647` (default `-1`)
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-h3-max-extend` — MiniMax H3 Max Extend

Try minimax-h3-max-extend in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`videoUrl`	`--video`	file	required video
`duration`	`-d`	range	`5`–`15`, step 1 (default `5`)
`output`	`--output`	enum	`extended` (Source + continuation) · `continuation` (Continuation only) (default `extended`)
`aspectRatio`	`--ar`	enum	`auto` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `auto`)
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` · `2k` (default `768p`)
`enhancePrompt`	`--enhance-prompt`	boolean	`true` · `false` (default `true`)
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)
`seed`	`--seed`	range	`0`–`2147483647`, step 1

`minimax-h3-max-relight` — MiniMax H3 Max Relight

Try minimax-h3-max-relight in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
`videoUrl`	`--video`	file	required video
`imageUrls`	`-i`	file	required image (up to 1)
`resolution`	`-r`	enum	`480p` · `768p` · `1080p` · `2k` (default `768p`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `16:9`)
`seed`	`--seed`	range	`0`–`2147483647`, step 1
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-h3-max-recast` — MiniMax H3 Max Recast

Try minimax-h3-max-recast in Playground ↗

Input type: v2v

Param	CLI flag	Type	Values
`prompt`	`-p`	text	free text (≤2000 chars)
`videoUrl`	`--video`	file	required video
`imageUrls`	`-i`	file	required image (up to 4)
`resolution`	`-r`	enum	`768p` · `1080p` (default `1080p`)
`enhanceRealism`	`--enhance-realism`	boolean	`true` · `false` (default `false`)
`seed`	`--seed`	range	`0`–`2147483647`, step 1
`enableSafetyChecker`	`--enable-safety-checker`	boolean	`true` · `false` (default `true`)

`minimax-m3` — MiniMax M3

Try minimax-m3 in Playground ↗

Input type: i2t

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`imageUrls`	`-i`	file	image (up to 8)

`minimax-m3.1-flash` — MiniMax M3.1 Flash

Try minimax-m3.1-flash in Playground ↗

Input type: i2t

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`imageUrls`	`-i`	file	image (up to 8)
`thinking`	`--thinking`	enum	`low` · `medium` · `high` (default `high`)

`minimax-h3-context-ir` — MiniMax H3 Context IR

Try minimax-h3-context-ir in Playground ↗

Input type: v2t

Param	CLI flag	Type	Values
`prompt`	`-p`	text	required
`startFrame`	`--start-frame`	file	image
`endFrame`	`--end-frame`	file	image
`imageUrls`	`-i`	file	image (up to 9)
`videoUrls`	`--video-urls`	file	video (up to 3)
`audioUrls`	`--audio-urls`	file	audio (up to 3)
`duration`	`-d`	range	`4`–`15`, step 1 (default `5`)
`aspectRatio`	`--ar`	enum	`adaptive` · `21:9` · `16:9` · `4:3` · `1:1` · `3:4` · `9:16` (default `adaptive`)

Pricing

bash

gen-ai pricing hailuo-2.3 --duration 10

Cost scales with duration and resolution (the Pro variants run at 1080p; 10s is 768p only). Music is priced per generated track.

MiniMax ​

Models ​

CLI ​

MCP ​

Parameters ​

hailuo-2.3 — Hailuo 2.3 ​

hailuo-2.3-pro — Hailuo 2.3 Pro ​

hailuo-2.3-fast — Hailuo 2.3 Fast ​

hailuo-2.3-fast-pro — Hailuo 2.3 Fast Pro ​

minimax-h3 — MiniMax H3 ​

minimax-h3-highspeed — MiniMax H3 Highspeed ​

minimax-h3-lite — MiniMax H3 Lite ​

minimax-music-v2 — MiniMax Music v2 ​

minimax-music-v3 — MiniMax Music v3 ​

minimax-h3-max — MiniMax H3 Max ​

minimax-h3-max-turbo — MiniMax H3 Max Turbo ​

minimax-h3-max-camera-controls — MiniMax H3 Max Camera Controls ​

minimax-h3-max-lip-sync — MiniMax H3 Max Lip Sync ​

minimax-h3-max-extend — MiniMax H3 Max Extend ​

minimax-h3-max-relight — MiniMax H3 Max Relight ​

minimax-h3-max-recast — MiniMax H3 Max Recast ​

minimax-m3 — MiniMax M3 ​

minimax-m3.1-flash — MiniMax M3.1 Flash ​

minimax-h3-context-ir — MiniMax H3 Context IR ​

Pricing ​

MiniMax

Models

CLI

MCP

Parameters

`hailuo-2.3` — Hailuo 2.3

`hailuo-2.3-pro` — Hailuo 2.3 Pro

`hailuo-2.3-fast` — Hailuo 2.3 Fast

`hailuo-2.3-fast-pro` — Hailuo 2.3 Fast Pro

`minimax-h3` — MiniMax H3

`minimax-h3-highspeed` — MiniMax H3 Highspeed

`minimax-h3-lite` — MiniMax H3 Lite

`minimax-music-v2` — MiniMax Music v2

`minimax-music-v3` — MiniMax Music v3

`minimax-h3-max` — MiniMax H3 Max

`minimax-h3-max-turbo` — MiniMax H3 Max Turbo

`minimax-h3-max-camera-controls` — MiniMax H3 Max Camera Controls

`minimax-h3-max-lip-sync` — MiniMax H3 Max Lip Sync

`minimax-h3-max-extend` — MiniMax H3 Max Extend

`minimax-h3-max-relight` — MiniMax H3 Max Relight

`minimax-h3-max-recast` — MiniMax H3 Max Recast

`minimax-m3` — MiniMax M3

`minimax-m3.1-flash` — MiniMax M3.1 Flash

`minimax-h3-context-ir` — MiniMax H3 Context IR

Pricing