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

# MiniMax H3

> MiniMax H3 video generation with text, first/last-frame animation, and multimodal reference guidance at 480p, 768p, 2K, or 4K.

MiniMax H3 video generation with text, first/last-frame animation, and multimodal reference guidance at 480p, 768p, 2K, or 4K. 2K and 4K upscale a 768p base result.

| | |
| - | - |
| Model id | `minimax-h3-fal` |
| Media | video |
| Submit to | `POST /v1/videos` |
| Price | varies by tier and settings; `GET /v1/models/minimax-h3-fal/estimate` quotes it |
| Typical time | about 360.0 s |

## Text → Video

Generate from a prompt. Choose an aspect ratio, duration, and output resolution.

Select it with `"mode": "text_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `duration_seconds`\
**Optional:** `aspect_ratio`

Resolution tiers: `480P`, `768P`, `2K`, `4K` (send as `tier`).

```json theme={null}
{
  "model": "minimax-h3-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "text_to_video",
  "aspect_ratio": "16:9",
  "duration_seconds": 5,
  "tier": "768P"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `"16:9"` |
| `duration_seconds` | 5.0 – 15.0 seconds | `5` |

## Image → Video

Animate a first frame, with an optional last frame. Output ratio follows the first image.

Select it with `"mode": "image_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `first_frame`, `duration_seconds`\
**Optional:** `last_frame`

Resolution tiers: `480P`, `768P`, `2K`, `4K` (send as `tier`).

```json theme={null}
{
  "model": "minimax-h3-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "image_to_video",
  "duration_seconds": 5,
  "first_frame": "asset_…",
  "tier": "768P"
}
```

| Field | Allowed | Default |
| - | - | - |
| `duration_seconds` | 5.0 – 15.0 seconds | `5` |
| `first_frame` | asset id (up to 1) | |
| `last_frame` | asset id (up to 1) | |

## Reference → Video

Attach at least one reference image or video to guide subjects, style, motion, and sound. Audio needs a visual reference; up to 12 files are accepted.

Select it with `"mode": "reference_to_video"`, or leave `mode` out and the inputs decide.

**Required:** `prompt`, `duration_seconds`\
**At least one of:** `reference_images`, `reference_videos`\
**Optional:** `reference_audios`, `aspect_ratio`

Resolution tiers: `480P`, `768P`, `2K`, `4K` (send as `tier`).

```json theme={null}
{
  "model": "minimax-h3-fal",
  "prompt": "A slow aerial shot over a misty pine forest at dawn",
  "mode": "reference_to_video",
  "aspect_ratio": "adaptive",
  "duration_seconds": 5,
  "tier": "768P"
}
```

| Field | Allowed | Default |
| - | - | - |
| `aspect_ratio` | `adaptive`, `21:9`, `16:9`, `4:3`, `1:1`, `3:4`, `9:16` | `"adaptive"` |
| `duration_seconds` | 5.0 – 15.0 seconds | `5` |
| `reference_images` | asset ids (up to 9) | |
| `reference_videos` | asset ids (up to 3) | |
| `reference_audios` | asset ids (up to 3) | |

Reference inputs take asset ids from [`POST /v1/uploads`](/uploads) or an earlier output's `asset_id`.
Prices and allowed values come from the live catalog; `GET /v1/models/minimax-h3-fal` is always current.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.