> ## 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 Video Overview

> A summary of MiniMax-H3's OpenAI-compatible and unified video interfaces.

# MiniMax-H3 Video

MiniMax-H3 provides both an OpenAI-compatible format and a unified video format. Both support text-to-video, image-to-video, and multimodal reference-to-video, as well as regenerating a 768P result into 2K.

## OpenAI Format

<CardGroup cols={2}>
  <Card title="Video Generation" icon="clapperboard" href="/en/videos/minimax-h3/generation">
    `POST /v1/videos`, create an async video task.
  </Card>

  <Card title="2K Regeneration" icon="wand-sparkles" href="/en/videos/minimax-h3/remix">
    `POST /v1/videos/{video_id}/remix`, regenerate a spec-compliant 768P result into 2K.
  </Card>

  <Card title="Task Query" icon="hourglass" href="/en/videos/minimax-h3/query">
    `GET /v1/videos/{task_id}`, query task status and results.
  </Card>
</CardGroup>

## Unified Video Format

<CardGroup cols={2}>
  <Card title="Create Video" icon="clapperboard" href="/en/videos/minimax-h3/unified-generation">
    `POST /v1/video/create`, create a task using the unified JSON format.
  </Card>

  <Card title="2K Regeneration" icon="wand-sparkles" href="/en/videos/minimax-h3/unified-remix">
    `POST /v1/video/remix`, pass the source task ID in the request body.
  </Card>

  <Card title="Query Task" icon="hourglass" href="/en/videos/minimax-h3/unified-query">
    `GET /v1/video/query?id=`, query task status and results.
  </Card>
</CardGroup>

## Supported Capabilities

| Scenario                      | Key parameters                                       | Aspect ratio rule                                    |
| ----------------------------- | ---------------------------------------------------- | ---------------------------------------------------- |
| Text-to-video                 | `prompt`                                             | Defaults to `16:9`; `adaptive` not allowed           |
| Image-to-video                | `image` or `images`                                  | Forced to `adaptive`                                 |
| Multimodal reference-to-video | `metadata.reference_video(s)` / `reference_audio(s)` | Defaults to `adaptive`                               |
| 2K Regeneration               | Source task ID or `metadata.base_video`              | Input must be a spec-compliant MiniMax-H3 768P video |

<Warning>
  Image-to-video and reference-video/reference-audio generation are mutually exclusive and cannot be mixed in the same request.
</Warning>

## Model and Limits

| Item              | Rule                                                     |
| ----------------- | -------------------------------------------------------- |
| Model             | `MiniMax-H3`                                             |
| Duration          | 4–15 seconds, default 5; out-of-range values are clamped |
| Output resolution | `768P`, `2K`, default `2K`                               |
| Request body      | Max 64 MB; public URLs recommended for large files       |
| Task retention    | Upstream retains the last 7 days                         |
| Polling interval  | 5–10 seconds recommended                                 |

## Endpoint Mapping

| Capability      | OpenAI Format                      | Unified Video Format      |
| --------------- | ---------------------------------- | ------------------------- |
| Create          | `POST /v1/videos`                  | `POST /v1/video/create`   |
| 2K Regeneration | `POST /v1/videos/{video_id}/remix` | `POST /v1/video/remix`    |
| Query           | `GET /v1/videos/{task_id}`         | `GET /v1/video/query?id=` |

## Related Pages

* [Video Model Support Matrix](/en/videos/model-matrix)
* [Video Generation (OpenAI Format)](./generation)
* [2K Regeneration (OpenAI Format)](./remix)
* [Task Query (OpenAI Format)](./query)
* [Create Video (Unified Format)](./unified-generation)
* [2K Regeneration (Unified Format)](./unified-remix)
* [Query Task (Unified Format)](./unified-query)