> ## 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  | 否  | 路由相關的生成控制和參考內容。                      |