Video generation API

Hailuo / MiniMax

MiniMax Hailuo 2.3 and 02 video generation — T2V, I2V, and Fast modes.

Provider: MiniMax10 models

Available models

Model key	Display name	Capability	Atlas Cloud slug
`hailuo_2_3_t2v_pro`	Hailuo 2.3 T2V Pro	text-to-video	minimax/hailuo-2.3/t2v-pro
`hailuo_2_3_t2v_std`	Hailuo 2.3 T2V Standard	text-to-video	minimax/hailuo-2.3/t2v-standard
`hailuo_2_3_i2v_pro`	Hailuo 2.3 I2V Pro	image-to-video	minimax/hailuo-2.3/i2v-pro
`hailuo_2_3_i2v_std`	Hailuo 2.3 I2V Standard	image-to-video	minimax/hailuo-2.3/i2v-standard
`hailuo_2_3_fast`	Hailuo 2.3 Fast	text-to-video	minimax/hailuo-2.3/fast
`hailuo_02_t2v_pro`	Hailuo 02 T2V Pro	text-to-video	minimax/hailuo-02/t2v-pro
`hailuo_02_t2v_std`	Hailuo 02 T2V Standard	text-to-video	minimax/hailuo-02/t2v-standard
`hailuo_02_i2v_pro`	Hailuo 02 I2V Pro	image-to-video	minimax/hailuo-02/i2v-pro
`hailuo_02_i2v_std`	Hailuo 02 I2V Standard	image-to-video	minimax/hailuo-02/i2v-standard
`hailuo_02_fast`	Hailuo 02 Fast	text-to-video	minimax/hailuo-02/fast

Endpoint

POST /api/generate

Request body

Parameter	Type	Required	Description
`modelKey`	string	✓	One of the model keys listed above
`prompt`	string	✓	Text description of the image to generate
`inputUrl`	string		Input image URL (for edit/i2i models)
`aspectRatio`	string		`"1:1"`, `"16:9"`, `"9:16"`, etc.
`imageQuality`	string		`"Low"`, `"Medium"`, `"High"`
`styleRef`	string \| string[]		Style reference image URL(s)
`charRef`	string \| string[]		Character reference image URL(s)
`brandId`	string		Brand DNA ID for brand-consistent generation

Code example

curl -X POST https://api.oyefilmy.com/api/generate \
  -H "Authorization: Bearer of_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "hailuo_2_3_t2v_pro",
    "prompt": "An underwater scene of coral reefs with colorful fish swimming, volumetric god rays"
  }'

Response

{
  "success": true,
  "predictionId": "pred_abc123...",
  "status": "processing",
  "model": "minimax/hailuo-2.3/t2v-pro",
  "creditCost": 5
}

Hailuo 2.3 is the latest generation. Pro variants produce higher quality. Fast mode is optimized for speed.

← All image models

Back to image generation overview

Webhooks

Receive results automatically