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

# MiniMax H3

> MiniMax H3 multimodal video generation through MixRoute, with text-to-video and asynchronous task examples.

MiniMax H3 is MiniMax's general-purpose multimodal video generation model available through MixRoute.

Use the exact model ID `MiniMax-H3` with the video generation endpoint.

## Key capabilities

* Multimodal video generation - Supports text-to-video, image-to-video, first-and-last-frame, and multimodal reference workflows
* Native audio - Can generate synchronized native stereo sound
* Flexible output - Provider specifications cover 768P and 2K output, 4 to 15 seconds, at 24 fps
* Asynchronous workflow - Submit a task, then poll for its result

<Note>
  Resolution, duration, audio, and reference-input combinations depend on the active MixRoute route. Check the Model Marketplace before relying on a specific combination in production.
</Note>

## Workflow

```text theme={null}
1. POST /v1/video/generations -> task_id
2. GET /v1/video/generations/{task_id} -> status
3. When the task succeeds -> read the video URL
```

## Text-to-video example

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/video/generations" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "MiniMax-H3",
        "prompt": "A product film with precise typography, smooth camera movement, and synchronized stereo sound",
        "asset": false
      }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.post(
        "https://api.mixroute.ai/v1/video/generations",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={
            "model": "MiniMax-H3",
            "prompt": "A product film with precise typography, smooth camera movement, and synchronized stereo sound",
            "asset": False,
        },
        timeout=60,
    )

    print(response.json())
    ```
  </Tab>
</Tabs>

## Query task status

```bash theme={null}
curl "https://api.mixroute.ai/v1/video/generations/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Parameters

| Parameter  | Type    | Required | Description                                                                                  |
| ---------- | ------- | -------- | -------------------------------------------------------------------------------------------- |
| `model`    | string  | Yes      | Must be `MiniMax-H3`.                                                                        |
| `prompt`   | string  | Yes      | Describes the target video, motion, sound, and creative intent.                              |
| `asset`    | boolean | Yes      | Set to `false` for text-only input; use `true` when the route request includes media assets. |
| `metadata` | object  | No       | Route-specific generation controls and reference content.                                    |