Hailuo (MiniMax) family

MiniMax’s Hailuo video generation models, two in total, called through the OfoxAI video endpoint POST /v1/videos. Tasks run asynchronously: creating a task returns a task ID, which you then use to query the result.

Choosing a model

Both support text-to-video, image-to-video, and video reference, and can generate a synchronized audio track (generate_audio defaults to true). adaptive keeps the input image’s aspect ratio.

The table above matches the video_attributes returned by the Models API; if model capabilities change, the API response takes precedence. Billing is per second, and the actual charge is usage.video_cost in the task result. For prices, see the model page .

Examples

The examples below show only the request that creates the task. For the full flow of querying status and downloading the result after creation, see Video API · Quickstart.

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Widescreen shot: a vintage car drives toward the setting sun on a desert highway",
    "duration": 6,
    "resolution": "768p",
    "aspect_ratio": "21:9"
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "The person in the frame turns and walks into the distance",
    "duration": 5,
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/hailuo-3",
    "prompt": "Keep the camera movement and restyle the footage as ink-wash animation",
    "duration": 5,
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images and input_references cannot be sent together; sending both returns 400 references_conflict.
• Pass "generate_audio": false when you do not need an audio track.
• For the full field structure, see Create video task.

Resolution values

Hailuo’s resolution tiers differ from other families: 768p and 2k (lowercase k). Passing 720p or 1080p, common in other families, returns 400.

Common errors

For the full list of error codes, see Video API error codes.

Official docs

• MiniMax Open Platform documentation 
• OfoxAI · Create video task

FAQ