> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifically.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Minimax Hailuo

> Generate videos with Minimax Hailuo models

Generate high-quality AI videos using Minimax Hailuo models.

## Models

| Model                     | Description                                     |
| ------------------------- | ----------------------------------------------- |
| `hailuo/minimax-2.0`      | MiniMax 02 — T2V and I2V with end frame support |
| `hailuo/minimax-2.3`      | MiniMax 2.3 — auto-selects T2V or I2V           |
| `hailuo/minimax-2.3-fast` | MiniMax I2V-2.3-Fast — faster image-to-video    |

## Parameters

### minimax-2.0

| Parameter             | Type    | Required | Description                                          |
| --------------------- | ------- | -------- | ---------------------------------------------------- |
| `prompt`              | string  | Yes\*    | Max 2000 chars. \*Required if no `start_image_url`   |
| `start_image_url`     | string  | Yes\*    | Image URL (auto-uploaded). \*Required if no `prompt` |
| `end_image_url`       | string  | No       | End frame image URL (768p/1080p only)                |
| `duration`            | integer | No       | `6` (default) or `10`. 1080p only supports `6`       |
| `resolution`          | string  | No       | `"768p"` (default), `"1080p"`                        |
| `prompt_optimization` | boolean | No       | Let MiniMax optimize prompt                          |

* **1080p** only supports `duration: 6`
* **end\_image\_url** only with 768p or 1080p
* At minimum one of `prompt` or `start_image_url` must be provided

### minimax-2.3

| Parameter             | Type    | Required | Description                                          |
| --------------------- | ------- | -------- | ---------------------------------------------------- |
| `prompt`              | string  | Yes\*    | Max 2000 chars. \*Required if no `start_image_url`   |
| `start_image_url`     | string  | Yes\*    | Image URL (auto-uploaded). \*Required if no `prompt` |
| `duration`            | integer | No       | `6` (default) or `10`. 1080p only supports `6`       |
| `resolution`          | string  | No       | `"768p"` (default), `"1080p"`                        |
| `prompt_optimization` | boolean | No       | Let MiniMax optimize prompt                          |

Auto-selects **T2V-2.3** (prompt only) or **I2V-2.3** (when `start_image_url` is provided).

### minimax-2.3-fast

| Parameter             | Type    | Required | Description                                    |
| --------------------- | ------- | -------- | ---------------------------------------------- |
| `prompt`              | string  | No       | Max 2000 chars                                 |
| `start_image_url`     | string  | **Yes**  | Image URL (auto-uploaded)                      |
| `duration`            | integer | No       | `6` (default) or `10`. 1080p only supports `6` |
| `resolution`          | string  | No       | `"768p"` (default), `"1080p"`                  |
| `prompt_optimization` | boolean | No       | Let MiniMax optimize prompt                    |

## Resolution Limits

| Model                          | 6s Duration | 10s Duration |
| ------------------------------ | ----------- | ------------ |
| minimax-2.0                    | 768p, 1080p | 768p only    |
| minimax-2.3 / minimax-2.3-fast | 768p, 1080p | 768p only    |

## Example Request

```bash theme={null}
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": "A beautiful sunset animation",
      "start_image_url": "https://example.com/sunset.jpg",
      "duration": 6,
      "resolution": "1080p"
    }
  }'
```

## With End Image (minimax-2.0 only)

```bash theme={null}
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": "Smooth transition between scenes",
      "start_image_url": "https://example.com/start.jpg",
      "end_image_url": "https://example.com/end.jpg",
      "duration": 6
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```