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

> 通过 MixRoute 调用 MiniMax H3 多模态视频生成模型，包含文生视频与异步任务示例。

MiniMax H3 是 MixRoute 当前提供的 MiniMax 通用多模态视频生成模型。

请在视频生成端点中使用完整模型 ID `MiniMax-H3`。

## 核心能力

* 多模态视频生成 - 支持文生视频、图生视频、首尾帧和多模态参考工作流
* 原生音频 - 可生成同步原生立体声音频
* 灵活输出 - 厂商规格覆盖 768P 与 2K、4 至 15 秒、24 fps
* 异步任务 - 提交任务后轮询获取结果

<Note>
  分辨率、时长、音频和参考输入的可用组合取决于当前 MixRoute 路由。生产环境使用特定组合前，请先查看模型广场。
</Note>

## 调用流程

```text theme={null}
1. POST /v1/video/generations -> task_id
2. GET /v1/video/generations/{task_id} -> status
3. 任务成功后 -> 读取视频 URL
```

## 文生视频示例

<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": "一支产品短片，文字排版准确，镜头运动流畅，并带有同步立体声",
        "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": "一支产品短片，文字排版准确，镜头运动流畅，并带有同步立体声",
            "asset": False,
        },
        timeout=60,
    )

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

## 查询任务状态

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

## 参数

| 参数         | 类型      | 必填 | 说明                                   |
| ---------- | ------- | -- | ------------------------------------ |
| `model`    | string  | 是  | 固定为 `MiniMax-H3`。                    |
| `prompt`   | string  | 是  | 描述目标视频、运动、声音和创作意图。                   |
| `asset`    | boolean | 是  | 纯文本输入设为 `false`；请求中包含媒体素材时设为 `true`。 |
| `metadata` | object  | 否  | 路由相关的生成控制和参考内容。                      |