> ## 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 视频 API

> MiniMax-H3 文生/图生/多模态视频、Context IR、480P~2K 与最长 30 秒。

# MiniMax-H3 视频 API

支持文生视频、图生视频（首尾帧）与多模态参考。分辨率 `480P` / `768P` / `1080P` / `2K`，时长 **4–30** 秒。模型：`MiniMax-H3`。

| 说明 | 方法 | 路径 |
| - | - | - |
| 创建 | `POST` | `/v1/videos`（也可 `/v1/video/generations`） |
| Context IR | `POST` | `/v1/videos/h3_context_ir` |
| 768P → 2K 重生成 | `POST` | `/v1/videos/regeneration` |
| 查询 | `GET` | `/v1/videos/{task_id}` |

**API 主机：** `https://api.omniall.ai` · 鉴权 `Authorization: Bearer sk-...`。

## 分辨率与时长

| 项 | 说明 |
| - | - |
| `resolution` | `480P` / `768P` / `1080P` / `2K` |
| `duration` / `seconds` | **4–30** 秒（整数） |
| Context IR | 开启增强理解时另收按次附加费（见模型详情） |

## 模式与 ratio

| 模式 | 何时 | `ratio` |
| - | - | - |
| t2va | 仅文本 | 必填，且不能为 `adaptive` |
| i2va | 首尾帧 | 强制 `adaptive` |
| r2va | `reference_*` | 可选（默认 `adaptive`） |

同一请求不要混用首尾帧与 `reference_*`。

```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": "一只猫走过竹林",
    "seconds": "10",
    "ratio": "16:9",
    "resolution": "1080P"
  }'
```

完整场景见 **API Reference → 视频 → MiniMax-H3**。


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