> For the complete documentation index, see [llms.txt](https://unsloth.ai/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unsloth.ai/docs/jp/moderu/minimax-h3.md).

# MiniMax-H3：ローカル環境での実行方法

音声付き動画のためにMiniMax-H3をローカルで実行し、UnslothでMiniMax-H3の動画LoRAをトレーニングします。

**MiniMax-H3** はMiniMaxのオープン動画モデルです。テキストプロンプトから動画とサウンドトラックを同時に生成でき、開始・終了フレームや参照画像、動画、音声も指定できます。 [Unsloth](https://unsloth.ai/docs/jp/desktop.md) でUnsloth FP8リポジトリを使って実行し、音声付きの短いクリップから独自のMiniMax-H3 LoRAをトレーニングできます。

{% columns %}
{% column width="50%" %}

* クリップは24 fpsで、長さは5.2～14.4秒です。
* デフォルト： **20ステップ**, **864 × 480**、5.2秒。
* 864 × 480の動画1本の生成には、およそ **30秒** かかります（RTX PRO 6000の場合）。
* LoRAのトレーニング：およそ **36分** （400ステップ、VRAMのピーク使用量は49.7 GB）。

MiniMax-H3： [FP8](https://huggingface.co/unsloth/MiniMax-H3-FP8) • [GGUF](https://huggingface.co/unsloth/MiniMax-H3-GGUF) • [オリジナル](https://huggingface.co/MiniMaxAI/MiniMax-H3)

RTX PRO 6000（96 GB）で、Unsloth 2026.11.4およびmainブランチのビルドを使ってテストしました。
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2Fyc83EeZRTERrxk24F75C%2Fminimax-h3-out-forest.webp?alt=media" alt="Aerial view over a misty pine forest and a winding river at sunrise"><figcaption><p>FP8リポジトリ、864 × 480、5.2秒（プレビューでは音声なし）</p></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### MiniMax-H3 LoRAファインチューニング - 前後比較

[MiniMax-H3のファインチューニング：前後の例](https://unsloth.ai/docs/jp/moderu/minimax-h3/fine-tune-minimax-h3.md#minimax-h3-lora-finetuning-before-and-after)

UnslothではMiniMax-H3のファインチューニングもできます。たとえば、Unslothのオリジナルbf16モデルを使い、864 × 480、5.2秒、20ステップ、シード42で実行できます。プロンプトは「bbbstyle, a sunny meadow with a big oak tree and a small stream, birds chirping」です。ファインチューニング前後のスタイルを示します。

<div><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FY40HyPvTZusQH0RDXU4I%2Fminimax-h3-lora-studio-before.webp?alt=media" alt="Without the LoRA: a realistic meadow with a big oak tree and a small stream under a blue sky"><figcaption><p>LoRAなし</p></figcaption></figure> <figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQxzr4zJRmMzlFE6OHCDi%2Fminimax-h3-lora-studio-after.webp?alt=media" alt="With the LoRA: the same meadow in a 3D animated film look, with a stylized oak tree, bright green grass and a small stream"><figcaption><p>bbbstyle LoRAあり、200ステップ</p></figcaption></figure></div>

### メモリ要件

| タスク                | ダウンロード                                                      | 合計      | GPUメモリ                |
| ------------------ | ----------------------------------------------------------- | ------- | --------------------- |
| **実行** （高速FP8）     | INT8動画モデル 20.3 GB、INT8 Qwen3-VL 32Bテキストエンコーダー 27.1 GB、VAE   | 約50 GB  | 使用中：54 GB             |
| **LoRA をトレーニングする** | オリジナルbf16リポジトリ：動画モデル 66.3 GB、テキストエンコーダー 66.7 GB、VAE 11.1 GB | 約144 GB | ピーク49.7 GB、80 GB以上を推奨 |

トレーニングでは、キャプションのエンコード時に63 GBのテキストエンコーダーを一度読み込み、その後、動画モデルの読み込み前に解放します。

### クイックスタート

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FWti8xb1Y3sOQBfG8oXMd%2Fminimax-h3-flow.webp?alt=media" alt="Animation: pick MiniMax H3 (Fast FP8), choose Text and frames, type a prompt, click Generate and play the forest clip" width="563"><figcaption><p>Unslothのワークフローを高速化</p></figcaption></figure>

{% stepper %}
{% step %}

#### Unslothをインストール

次を使用するか、 [Unsloth Desktopアプリ](https://unsloth.ai/docs/jp/desktop.md) ターミナルからインストールしてください。

<a href="https://unsloth.ai/download" class="button primary" data-icon="down-to-bracket">Unslothをダウンロード</a>

MacOS、Linux、WSL：

```bash
curl -fsSL https://unsloth.ai/install.sh | sh
```

Windows PowerShell：

```powershell
irm https://unsloth.ai/install.ps1 | iex
```

Unslothを起動して、 `http://localhost:8888`:

```bash
unsloth studio -H 0.0.0.0 -p 8888
```

{% endstep %}

{% step %}

#### サイドバーで

「 **画像** 」を開き、 **動画** を右上でクリックするか、次に移動します `http://localhost:8888/video`.

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FqCq3GkDxVruGcu5LGHPi%2Fminimax-h3-video-page.png?alt=media" alt="The Unsloth Video page with the Create tab open and no model loaded"><figcaption><p>Videoページ</p></figcaption></figure>
{% endstep %}

{% step %}

#### MiniMax-H3を選択する

クリック **動画モデルを選択**で検索し、 `MiniMax-H3` を選択します **MiniMax H3 (Fast FP8)**.

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FbRd7iMQUQKMxQt8erID0%2Fminimax-h3-picker.png?alt=media" alt="Model picker search results for MiniMax-H3 with the Fast FP8, GGUF, FP8 and original entries" width="540"><figcaption><p>モデル選択メニュー</p></figcaption></figure>

モードを選択します：

* **テキストとフレーム**：プロンプトと、任意の開始フレームおよび終了フレーム。
* **参照素材**：参照画像、動画、音声。モデルのダウンロードが別途必要です。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FG589ovJjwsvgaLILbmrH%2Fminimax-h3-mode.png?alt=media" alt="Dialog: Choose how MiniMax H3 should generate, with the Text and frames and References options" width="450"><figcaption><p>モードダイアログ</p></figcaption></figure>
{% endstep %}

{% step %}

#### プロンプトと設定を指定する

シーン、カメラ、音声を説明します。 **学習済みサイズ** からサイズを選び、 **長さ**を指定します。その他の設定はUnslothが自動入力します。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FA3ocFMljlYqyFZIVQnGg%2Fminimax-h3-settings.png?alt=media" alt="Create panel with the forest prompt, empty start and end frames, 864 by 480, 5.2 seconds and 124 frames, 24 fps, 20 steps, motion shift 12, audio shift 3 and seed 42" width="400"><figcaption><p>設定画面</p></figcaption></figure>
{% endstep %}

{% step %}

#### 生成

クリック **生成**します。プレビューでは音声付きで動画が再生されます。設定を確認するには **レシピ** を、保存するには **ダウンロード** を使用します。

<figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2F1kKizKGOjO83IGdw1PAa%2Fminimax-h3-result.png?alt=media" alt="Finished video of a misty pine forest and river at sunrise in the Video page preview, with the gallery below"><figcaption><p>生成結果（シード値：42）</p></figcaption></figure>

最初の動画はモデルのコンパイルに数分かかります。
{% endstep %}
{% endstepper %}

プロンプト：「霧に包まれた松林と、日の出の光に照らされた曲がりくねる川の上を、ゆっくりと空撮する。霧を金色の光が照らし、鳥のさえずりと岩の上を流れる水の音が聞こえる。映画のような自然映像。」

### 開始フレーム、終了フレーム、参照素材

* **開始フレーム**：動画は指定した画像から始まります。画像をここにドロップします。 **開始フレーム**.
* **終了フレーム**：動画は指定した画像で終わります。両方を使うと、2枚の画像間を移動する動画を作成できます。
* **参照素材**：MiniMax-H3を **参照素材** モードで読み込み、画像、動画、音声トラックを使って動画を誘導します。
* 画像の縦横比は1:4から4:1の範囲にしてください。フレーム間の動きをプロンプトで説明します。

### 推奨設定

| 設定           | 値                                       |
| ------------ | --------------------------------------- |
| **ステップ数**    | 20                                      |
| **ガイダンス**    | 使用しません（ガイダンス蒸留済み）                       |
| **フレームレート**  | 24 fps                                  |
| **長さ**       | 5.2秒（124フレーム）～14.4秒（345フレーム）、17フレーム刻み   |
| **サイズ**      | まずは864 × 480。最大で1344 × 768または1536 × 672 |
| **モーションシフト** | 12                                      |
| **音声シフト**    | 3                                       |
| **シード**      | 同じ結果を再現するには任意の数値を指定                     |

#### T4など、bf16非対応のGPU

次の **GGUF** エントリを使用してください。bf16非対応の場合、FP8リポジトリと元の重みはfloat32にフォールバックし、約288 GBのシステムRAMが必要になります。そのため、容量の少ないマシンでは、Unslothはダウンロードを開始する前にこれらの使用を拒否し、GGUF版を案内します（Unsloth 2026.11.4より新しいバージョンが必要です）。

15 GBのColab T4では、GGUFの **UD-Q2\_K\_XL** とQ2\_K\_Mテキストエンコーダーを使用し、864 x 480、124フレーム、20ステップでレンダリングした場合、約 **34分** かかり、システムRAMを約26 GB使用します。

### LoRA をトレーニングする

MiniMax-H3のファインチューニング方法については、 [MiniMax-H3をファインチューニングする](https://unsloth.ai/docs/jp/moderu/minimax-h3/fine-tune-minimax-h3.md) をご覧ください。例として、2つの動画はいずれも読み込みを含めてRTX PRO 6000で約10分かかりました。400ステップのLoRAを使った同じペアは右側にあります。

<div><figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FQ9SnobeErT5EubX2JC3I%2Fminimax-h3-lora-meadow-before.webp?alt=media" alt="Without the LoRA: a realistic meadow with a big oak tree and a small stream under a blue sky"><figcaption><p>LoRAなし</p></figcaption></figure> <figure><img src="https://735611837-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxhOjnexMCB3dmuQFQ2Zq%2Fuploads%2FLrEdDhkeBntupm1TbjDb%2Fminimax-h3-lora-meadow-after.webp?alt=media" alt="With the LoRA: the same meadow in a 3D animated film look, with stylized oak trees, soft light and a small animated character"><figcaption><p>bbbstyle LoRA、400ステップ</p></figcaption></figure></div>

#### LoRAを使用する

「 [MiniMax-H3をファインチューニングする](https://unsloth.ai/docs/jp/moderu/minimax-h3/fine-tune-minimax-h3.md#use-the-lora)

#### Unsloth以外：diffusers

「 [MiniMax-H3をファインチューニングする](https://unsloth.ai/docs/jp/moderu/minimax-h3/fine-tune-minimax-h3.md#outside-unsloth-diffusers)

### トラブルシューティング

「 [MiniMax-H3をファインチューニングする](https://unsloth.ai/docs/jp/moderu/minimax-h3/fine-tune-minimax-h3.md#troubleshooting)

<details>

<summary>動画モデルの選択メニューにMiniMax-H3が表示されない場合</summary>

[Unslothを更新](https://unsloth.ai/docs/get-started/install/updating) して再起動してください。モデルが読み込まれている場合は、選択メニューで **推奨** をクリックしてください。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://unsloth.ai/docs/jp/moderu/minimax-h3.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
