Create text-to-video job

​

Hailuo (MiniMax-Hailuo) video

​

Quick flow

1. Submit job → get task_id
2. Poll status → wait until status is completed for a public URL

​

Basics

• Endpoint: POST /v1/video/generations
• Auth: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
• Content-Type: application/json

​

Request body

​

Camera commands

• Truck / pedestal: [truck left], [truck right], [pedestal up], [pedestal down]
• Pan / tilt: [pan left], [pan right], [tilt up], [tilt down]
• Dolly / zoom: [dolly in], [dolly out], [zoom in], [zoom out]
• Other: [handheld shake], [follow], [locked off]

Compatibility: The live API may still expect Chinese bracket keywords from the vendor. If a prompt is rejected, use the Chinese tag spellings from the Chinese docs or provider reference.

​

Response

​

Example

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "A kitten running through the forest, [dolly in], then [pan left]",
  "duration": 6,
  "metadata": {
    "prompt_optimizer": true,
    "resolution": "1080P",
    "callback_url": "https://your-server.com/callback"
  }
}

​

Notes

1. Async: 200 only means the job was accepted—poll or use callback_url for the final URL.
2. Callback verify: MiniMax POSTs to callback_url; echo the challenge within ~3s to verify.
3. Resolution: MiniMax-Hailuo-2.3 and 02 10s clips may only allow 768P.