MiniMax Hailuo - Unifically

Generate videos using the models and controls exposed by the official Hailuo website integration. Reference images are downloaded from their public URLs and uploaded to Hailuo automatically.

Models

Model	Supported mode
`hailuo/minimax-2.0`	Start frame, end frame, or start + end frames
`hailuo/minimax-2.3`	Start-frame image-to-video
`hailuo/minimax-2.3-fast`	Faster start-frame image-to-video
`hailuo/minimax-h3`	Text-to-video, start/end frames, or 1-12 omni-reference images

MiniMax 2.0

Provide at least one frame. A start frame, an end frame, or both are supported.

Parameter	Type	Required	Description
`prompt`	string	Yes	Video prompt, 1-2000 characters
`start_frame_url`	string	Conditional	Public HTTP(S) start-frame image URL. Required when `end_frame_url` is omitted
`end_frame_url`	string	Conditional	Public HTTP(S) end-frame image URL. Can be used by itself or with `start_frame_url`
`duration`	integer	No	`6` (default) or `10` seconds. `1080p` only supports `6`
`resolution`	string	No	`"512p"`, `"768p"` (default), or `"1080p"`
`prompt_optimizer`	boolean	No	Enable Hailuo prompt optimization. Default `true`; set `false` to preserve the original prompt
`nsfw_check`	boolean	No	Check uploaded media inputs for NSFW content. Default: `true`

The output aspect ratio follows the supplied frame. There is no aspect_ratio parameter for MiniMax 2.0.

Start and end frame example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "hailuo/minimax-2.0",
    "input": {
      "prompt": "The subject turns toward the camera and begins dancing",
      "start_frame_url": "https://example.com/start.jpg",
      "end_frame_url": "https://example.com/end.jpg",
      "duration": 6,
      "resolution": "768p",
      "prompt_optimizer": true
    }
  }'

MiniMax 2.3 and 2.3 Fast

Both models require a start frame. They do not accept an end frame, text-only mode, aspect_ratio, or prompt_optimizer.

Parameter	Type	Required	Description
`prompt`	string	Yes	Video prompt, 1-2000 characters
`start_frame_url`	string	Yes	Public HTTP(S) start-frame image URL
`duration`	integer	No	`6` (default) or `10` seconds. `1080p` only supports `6`
`resolution`	string	No	`"768p"` (default) or `"1080p"`
`nsfw_check`	boolean	No	Check uploaded media inputs for NSFW content. Default: `true`

Use hailuo/minimax-2.3-fast with the same input object to select the faster model.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "hailuo/minimax-2.3",
    "input": {
      "prompt": "A slow cinematic camera orbit",
      "start_frame_url": "https://example.com/start.jpg",
      "duration": 6,
      "resolution": "1080p"
    }
  }'

MiniMax H3

MiniMax H3 supports three mutually exclusive input modes.

Mode	Inputs	Aspect ratio behavior
Text-to-video	Prompt only	Defaults to `"16:9"`; choose any supported fixed ratio
Frame-guided	`start_frame_url`, optionally `end_frame_url`	Determined automatically by the frame; omit `aspect_ratio`
Omni-reference	`image_urls` containing 1-12 images	Defaults to `"auto"`; `"auto"` or a fixed ratio may be selected

Parameter	Type	Required	Description
`prompt`	string	Yes	Video prompt, 1-2000 characters. In omni-reference mode, use `@Image1` through `@Image12` to identify images
`image_urls`	string[]	No	1-12 public HTTP(S) omni-reference image URLs
`start_frame_url`	string	No	Public HTTP(S) start-frame image URL. Cannot be combined with `image_urls`
`end_frame_url`	string	No	Public HTTP(S) end-frame image URL. Requires `start_frame_url` and cannot be combined with `image_urls`
`aspect_ratio`	string	No	`"auto"`, `"21:9"`, `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, or `"9:16"`. See mode-specific rules above
`resolution`	string	No	`"768p"` or `"2K"` (default)
`duration`	integer	No	Any whole number from `4` through `15`. Default `5`
`nsfw_check`	boolean	No	Check uploaded media inputs for NSFW content. Default: `true`

MiniMax H3 does not accept reference videos, reference audio, seed, or prompt_optimizer.

Text-to-video example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "hailuo/minimax-h3",
    "input": {
      "prompt": "A street musician performs as the crowd claps along",
      "aspect_ratio": "21:9",
      "resolution": "2K",
      "duration": 10
    }
  }'

Omni-reference example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "hailuo/minimax-h3",
    "input": {
      "prompt": "@Image1 walks through the location shown in @Image2",
      "image_urls": [
        "https://example.com/character.jpg",
        "https://example.com/location.jpg"
      ],
      "aspect_ratio": "auto",
      "resolution": "768p",
      "duration": 6
    }
  }'

Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}

Poll the task status endpoint until it becomes completed or failed. Failed Hailuo tasks include sanitized upstream diagnostics in task metadata when available.

Volume discounts are available for almost all models. Reach out at contact@unifically.com to discuss custom pricing.

​Models

​MiniMax 2.0

​Start and end frame example

​MiniMax 2.3 and 2.3 Fast

​MiniMax H3

​Text-to-video example

​Omni-reference example

​Response

Models

MiniMax 2.0

Start and end frame example

MiniMax 2.3 and 2.3 Fast

MiniMax H3

Text-to-video example

Omni-reference example

Response