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

# MiniMax-H3 video API

> MiniMax-H3 text/image/multimodal video, Context IR, 480P–2K, up to 30s, and 2K regeneration.

# MiniMax-H3 video API

Supports text-to-video, image-to-video (first/last frame), and multimodal reference. Resolution `480P` / `768P` / `1080P` / `2K`, duration **4–30** seconds. Model: `MiniMax-H3`.

| Action | Method | Path |
| - | - | - |
| Create | `POST` | `/v1/videos` (also `/v1/video/generations`) |
| Context IR | `POST` | `/v1/videos/h3_context_ir` |
| 768P → 2K regen | `POST` | `/v1/videos/regeneration` |
| Get result | `GET` | `/v1/videos/{task_id}` |

**Host:** `https://api.omniall.ai` · Auth `Authorization: Bearer sk-...`.

## Resolution & duration

| Field | Notes |
| - | - |
| `resolution` | `480P` / `768P` / `1080P` / `2K` |
| `duration` / `seconds` | **4–30** seconds (integer) |
| Context IR | Optional per-call surcharge when enhanced understanding is enabled (see model details) |

## Modes & ratio

| Mode | When | `ratio` |
| - | - | - |
| t2va | text only | required, not `adaptive` |
| i2va | first/last frame | forced `adaptive` |
| r2va | `reference_*` | optional (default `adaptive`) |

Do not mix first/last frames with `reference_*` in one request.

```bash theme={null}
curl -X POST "https://api.omniall.ai/v1/videos" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "prompt": "A cat walking through a bamboo forest",
    "seconds": "10",
    "ratio": "16:9",
    "resolution": "1080P"
  }'
```

Full scenarios: **API Reference → Video → MiniMax-H3**.


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