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

# MiniMax H3

> MiniMax H3 — 全模态视频生成,文生 / 图生 / 参考生三合一,原生出声,4–15 秒

MiniMax H3 是 MiniMax 2026 年 7 月发布的全模态视频模型。一个 endpoint 同时吃**文本、图片、视频、音频**四类输入,单次渲染直接出**带音轨**的成片,不用再单独配音。

三种用法在同一个接口里,靠传什么决定:

* **文生视频** — 只给 `prompt`
* **图生视频** — 给 `image_urls`,或用 `first_frame_image` / `last_frame_image` 指定首尾帧
* **参考生视频** — 给 `video_urls`(参考运镜与风格)或 `audio_urls`(参考节奏与配乐)

异步任务:提交返回 `task_id`,轮询 [任务状态](/cn/api-reference/task/status) 直到 `completed`。

## 定价

<Note>
  本页不列单价 —— 价格会随上游调整,写在文档里迟早和实际对不上。

  **看实时价格:** 控制台「模型市场」,或 `GET /v1/models` 查询接口(见 [模型列表](/cn/docs/models))。
  **看单次实际花费:** 每次调用的响应里都带 `cost` / `usage.cost`,以它为准。
</Note>

## 可用模型

| 模型 ID                     | 分辨率             | 时长(秒)     | 音轨   | 特色                                        |
| ------------------------- | --------------- | --------- | ---- | ----------------------------------------- |
| `minimax-h3`              | `768p` / `2k`   | 4–15 任意整数 | ✅ 原生 | 全模态输入,单次出带声成片                             |
| `minimax-h3-max`          | `480p` / `768p` | 4–15 任意整数 | ✅ 原生 | 更快更省的低分辨率档,能力与 H3 相同                      |
| `minimax-h3-regeneration` | `2k`            | 4–15 任意整数 | ✅ 原生 | 把已有的 768p H3 成片按原生 2K 重渲染,`video_urls` 必传 |

按 **分辨率 × 时长** 计费,`2k` 档更贵。**传参考视频(`video_urls`)时按 2× 单价计**:上游按输入视频时长 + 输出时长收,这是过渡折算;`minimax-h3-regeneration` 的单价已含输入部分,不再翻倍。参考图前 5 张免费,之后上游按张加收,我们目前**不另计**。

## 调用示例

<CodeGroup>
  ```bash 文生视频 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "minimax-h3",
      "prompt": "清晨的山间小镇,雾气缓缓散开,镜头从屋顶推向远山",
      "resolution": "2k",
      "duration": 8
    }'
  ```

  ```bash 图生视频(单张作首帧) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "minimax-h3",
      "prompt": "人物缓缓抬头,风吹动头发,镜头轻微推近",
      "image_urls": ["https://cdn.example.com/portrait.jpg"],
      "resolution": "768p",
      "duration": 6
    }'
  ```

  ```bash 首尾帧 theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "minimax-h3",
      "prompt": "从白天过渡到夜晚,灯光逐盏亮起",
      "first_frame_image": "https://cdn.example.com/day.jpg",
      "last_frame_image": "https://cdn.example.com/night.jpg",
      "duration": 10
    }'
  ```

  ```bash 参考生视频(视频 + 音频) theme={"system"}
  curl -X POST https://www.qingbo.dev/v1/tasks \
    -H "Authorization: Bearer $WAVE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "minimax-h3",
      "prompt": "同样的运镜节奏,换成雪山场景",
      "video_urls": ["https://cdn.example.com/reference.mp4"],
      "audio_urls": ["https://cdn.example.com/bgm.mp3"],
      "resolution": "2k",
      "duration": 12
    }'
  ```
</CodeGroup>

## 通用参数

<ParamField body="model" type="string" required>
  固定 `minimax-h3`
</ParamField>

<ParamField body="prompt" type="string" required>
  画面描述。即使给了参考素材也建议写清楚要什么 —— 参考素材负责"像什么",prompt 负责"做什么"
</ParamField>

<ParamField body="resolution" type="string" default="768p">
  `768p` / `2k`
</ParamField>

<ParamField body="duration" type="integer" default="5">
  4–15 之间任意整数秒
</ParamField>

<ParamField body="image_urls" type="string[]">
  参考图或首帧。公网可访问的图片 URL
</ParamField>

<ParamField body="first_frame_image" type="string">
  首帧图 URL
</ParamField>

<ParamField body="last_frame_image" type="string">
  尾帧图 URL,与 `first_frame_image` 配合做「从 A 变到 B」
</ParamField>

<ParamField body="video_urls" type="string[]">
  参考视频,提供运镜、节奏与风格参考
</ParamField>

<ParamField body="audio_urls" type="string[]">
  参考音频,影响成片的节奏与配乐走向
</ParamField>

<ParamField body="callback_url" type="string">
  任务到达终态时回调,见[回调机制](/cn/docs/sync-async#async-task-webhook)
</ParamField>

<Note>
  **图生与参考生互斥。** 首尾帧(`first_frame_image` / `last_frame_image`)与参考素材(`video_urls` / `audio_urls`)不能在同一次请求里混用 —— 上游把它们当两种不同的生成模式。
</Note>

## 资源限制

| 项目      | 限制               |
| ------- | ---------------- |
| 参考图     | 最多 9 张           |
| 参考视频    | 最多 3 段,每段 2–15 秒 |
| 参考音频    | 最多 3 段,每段 2–15 秒 |
| 参考素材总时长 | ≤ 15 秒           |
| 提示词     | ≤ 7000 字符        |

## 相关文档

* [任务系统](/cn/docs/task-system) — 提交、轮询、回调
* [模型列表](/cn/docs/models) — 查询可用模型与实时单价