> ## 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.

<Tip>
  See [MiniMax H3 API](/api-reference/endpoint/minimax-h3) for the complete field reference. On MixRoute, put H3 controls in `metadata.content`, `metadata.resolution`, `metadata.duration`, and `metadata.ratio`.
</Tip>

<Info>
  Keep `model` and `prompt` at the root. Put H3 content and output controls in `metadata`, including `content`, `resolution`, `duration`, and `ratio`. Keep the prompt consistent with the text content.
</Info>

## Examples

Set `MIXROUTE_API_KEY` to your MixRoute key. Replace reference URLs or Base64 placeholders with your own accessible media. Each request creates a billable generation task when accepted.

<Tabs>
  <Tab title="Text to video">
    ```bash theme={null}
    curl --location "https://api.mixroute.ai/v1/video/generations" \
      --header "Authorization: Bearer $MIXROUTE_API_KEY" \
      --header "Content-Type: application/json" \
      --data '{
      "model": "MiniMax-H3",
      "prompt": "A professor is teaching a class in a classroom.",
      "metadata": {
        "content": [
          {
            "type": "text",
            "text": "A professor is teaching a class in a classroom."
          }
        ],
        "resolution": "768P",
        "duration": 4,
        "ratio": "9:16"
      }
    }'
    ```
  </Tab>
</Tabs>

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "MiniMax-H3",
  "prompt": "A professor is teaching a class in a classroom.",
  "metadata": {
    "content": [
      {
        "type": "text",
        "text": "A professor is teaching a class in a classroom."
      }
    ],
    "resolution": "768P",
    "duration": 4,
    "ratio": "9:16"
  }
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/video/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=60,
)
response.raise_for_status()
print(response.json())
```

## Task Results

Use the returned MixRoute task ID with [Query Video Task](/api-reference/endpoint/query-video-task). The gateway response is not necessarily the vendor's native response envelope.


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