> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# MiniMax H3 与 H3 Turbo

MiniMax H3 是平台的主力视频族:四种输入模式、三档速度、原生音频输出、24 fps。

## 模型 ID 一览

| 任务            | base                                 | balanced                | turbo           |
| ------------- | ------------------------------------ | ----------------------- | --------------- |
| 文生视频 t2v      | `minimax-h3-fl2va-fp8_t2v`           | `…_t2v_balanced`        | `…_t2v_turbo`   |
| 图生视频 i2v      | `…_i2v`                              | `…_i2v_balanced`        | `…_i2v_turbo`   |
| 首尾帧 flf2v     | `…_flf2v`                            | `…_flf2v_balanced`      | `…_flf2v_turbo` |
| 参考视频 r2v      | `minimax-h3-ref2va-fp8_r2v`          | `…_r2v_balanced`        | `…_r2v_turbo`   |
| 两段式 r2v       | `…_r2v_2stage`                       | `…_r2v_balanced_2stage` | —               |
| 混合 int8       | `minimax-h3-fl2va-ref2va-int8_r2v`   | —                       | —               |
| 混合 int8 flf2v | `minimax-h3-fl2va-ref2va-int8_flf2v` | —                       | —               |

## 档位差异

| 档位       | 步数                       | 采样器           | 参考表     |
| -------- | ------------------------ | ------------- | ------- |
| base     | 20(固定)                   | res_multistep | 质量优先    |
| balanced | 8(固定) + shift 4–12(默认 6) | —             | 速度/质量折中 |
| turbo    | 4(固定)                    | euler         | 最快出片    |

## 共同参数边界

| 参数   | 取值                                             |
| ---- | ---------------------------------------------- |
| 提示词  | ≤ 7000 字符                                      |
| 尺寸   | 480–1344,步进 32;默认 1344×768,`maxPixels` 1032192 |
| 帧数   | 124–362,步进 17(即约 5–15 秒 @24fps)                |
| 帧率   | 24 fps(固定)                                     |
| 音频   | 原生音频;`generateAudio` 缺省开启,可关                   |
| 引导系数 | 固定 `1`                                         |

细节以目录与参数卡(`GET /v1/model-catalog/{id}`)为准。

## 输入模式

- **t2v**:仅文本;
- **i2v**:参考图作首帧(`referenceImage`);
- **flf2v**:首帧 + 尾帧(`referenceImage` + `referenceImageEnd`);
- **r2v**:多参考(`inputMode: multi-reference`):上限 **9 图 / 3 视频 / 3 音频 / 12 资产**,`referenceImage` + `contextImages`。
  - 两段式(`_2stage`):同 r2v 输入,先渲染后放大精修,尺寸下限降至 384(384–1344),输出翻倍分辨率。
  - 混合 int8(`minimax-h3-fl2va-ref2va-int8_flf2v` / `_r2v`):12 步,帧上限 481,默认竖屏 704×1280。

:::tip 关键帧(keyframes)
除 t2v 外,H3 全族支持**中间关键帧**:最多 8 张,以 `{image, frameIndex}` 钉在 24fps 时间线上(帧 0 与最后一帧由输入模式占据)。SDK 上传槽位为 `keyframeImage1..8`。
:::

## 用法

```js
const project = client.projects.create({
  modelId: 'minimax-h3-fl2va-fp8_t2v_turbo',
  positivePrompt: '一只橘猫在雨后的屋顶上伸懒腰,镜头缓慢推进,环境音',
});
const [videoUrl] = await project.waitForCompletion();
```

输入上传与槽位见[媒体与图像 URL](https://docs.reelway.ai/api-reference/media.md);配方见[生成配方](https://docs.reelway.ai/api-reference/direct-generation.md)。