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

# MiniMax-H3 视频概览

> 汇总 MiniMax-H3 的 OpenAI 兼容格式与统一视频接口。

# MiniMax-H3 视频

MiniMax-H3 提供 OpenAI 兼容格式与统一视频格式两套入口，均支持文生视频、图生视频、多模态参考生视频，以及将 768P 结果再生成为 2K 视频。

## OpenAI 格式

<CardGroup cols={2}>
  <Card title="视频生成" icon="clapperboard" href="/zh/videos/minimax-h3/generation">
    `POST /v1/videos`，创建异步视频任务。
  </Card>

  <Card title="2K 再生成" icon="wand-sparkles" href="/zh/videos/minimax-h3/remix">
    `POST /v1/videos/{video_id}/remix`，将符合规格的 768P 结果再生成为 2K。
  </Card>

  <Card title="任务查询" icon="hourglass" href="/zh/videos/minimax-h3/query">
    `GET /v1/videos/{task_id}`，查询任务状态与结果。
  </Card>
</CardGroup>

## 统一视频格式

<CardGroup cols={2}>
  <Card title="创建视频" icon="clapperboard" href="/zh/videos/minimax-h3/unified-generation">
    `POST /v1/video/create`，使用统一 JSON 格式创建任务。
  </Card>

  <Card title="2K 再生成" icon="wand-sparkles" href="/zh/videos/minimax-h3/unified-remix">
    `POST /v1/video/remix`，通过请求体传入源任务 ID。
  </Card>

  <Card title="查询任务" icon="hourglass" href="/zh/videos/minimax-h3/unified-query">
    `GET /v1/video/query?id=`，查询任务状态与结果。
  </Card>
</CardGroup>

## 支持能力

| 场景       | 关键参数                                                 | 宽高比规则                          |
| -------- | ---------------------------------------------------- | ------------------------------ |
| 文生视频     | `prompt`                                             | 默认 `16:9`，不可使用 `adaptive`      |
| 图生视频     | `image` 或 `images`                                   | 强制使用 `adaptive`                |
| 多模态参考生视频 | `metadata.reference_video(s)` / `reference_audio(s)` | 默认 `adaptive`                  |
| 2K 再生成   | 源任务 ID 或 `metadata.base_video`                       | 输入必须是符合 MiniMax-H3 规格的 768P 视频 |

<Warning>
  图生视频与通过参考视频或参考音频生成互斥，不可在同一请求中混用。
</Warning>

## 模型与限制

| 项目    | 规则                      |
| ----- | ----------------------- |
| 模型    | `MiniMax-H3`            |
| 生成时长  | 4～15 秒，默认 5 秒；超出范围会自动钳制 |
| 输出分辨率 | `768P`、`2K`，默认 `2K`     |
| 请求体   | 最大 64 MB；大文件建议使用公网 URL  |
| 任务记录  | 上游保留最近 7 天              |
| 轮询间隔  | 建议 5～10 秒               |

## 接口对照

| 能力     | OpenAI 格式                          | 统一视频格式                    |
| ------ | ---------------------------------- | ------------------------- |
| 创建     | `POST /v1/videos`                  | `POST /v1/video/create`   |
| 2K 再生成 | `POST /v1/videos/{video_id}/remix` | `POST /v1/video/remix`    |
| 查询     | `GET /v1/videos/{task_id}`         | `GET /v1/video/query?id=` |

## 相关页面

* [视频模型支持矩阵](/zh/videos/model-matrix)
* [视频生成（OpenAI 格式）](./generation)
* [2K 再生成（OpenAI 格式）](./remix)
* [任务查询（OpenAI 格式）](./query)
* [创建视频（统一格式）](./unified-generation)
* [2K 再生成（统一格式）](./unified-remix)
* [查询任务（统一格式）](./unified-query)