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

# MiniMax-H3-Image: ComfyUI で 16 MP のテキストから画像生成と画像編集

> ComfyUI で MiniMax-H3-Image を実行：テキストto画像とプロンプト駆動の画像編集を約 16 MP で行える単一のオープンウェイト checkpoint で、6 サンプラーステップに蒸留されています。

**MiniMax-H3-Image** は MiniMax のオープンウェイト画像モデルで、1つの checkpoint がテキストから画像への生成と画像編集の両方をカバーします。diffusion transformer は BF16 で 33.1B パラメータを持ち、CFG を使わない 6 ステップのサンプラーに蒸留されています。出力は約 16 MP のネイティブ解像度なので、4096 x 4096 の画像はアップスケールの連鎖ではなく 1 回のパスで生成できます。

**関連リンク**

* [MiniMaxAI/MiniMax-H3-Image (Hugging Face)](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image)：公式のモデルカードと重み
* [MiniMax-H3-Image (ModelScope)](https://modelscope.cn/models/minimax/MiniMax-H3-Image)：中国本土向けの公式ミラー
* [MiniMax-AI/MiniMax-H3-Image (GitHub)](https://github.com/MiniMax-AI/MiniMax-H3-Image)：公式のサンプルと skill
* [Comfy-Org/MiniMax-H3-Image (Hugging Face)](https://huggingface.co/Comfy-Org/MiniMax-H3-Image): diffusion モデルと画像 VAE
* [Comfy-Org/MiniMax-H3 (Hugging Face)](https://huggingface.co/Comfy-Org/MiniMax-H3): このモデルが使用する Qwen3-VL-32B text encoder
* [MiniMaxAI/MiniMax-H3-Image-PE (Hugging Face)](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image-PE): 公式の prompt expander

## 主な機能

* **テキストから画像生成と編集を1つのcheckpointで**: 編集用のモデルやアダプターを別途読み込む必要はありません
* **6ステップのサンプリング**: ガイダンスは1に固定されているため、CFGパスもネガティブプロンプトもありません
* **ネイティブで約16 MP**: アップスケール処理なしで4096 x 4096、最大6272 x 2688まで
* **複数の参照**: 最大16枚の入力画像を、プロンプト内で `<Picture 1>` 以降として指定
* **オプションのプロンプトエキスパンダー**: 短いリクエストを、モデルが最もよく読み取る詳細なキャプションに変換します
* **オープンウェイト**: ComfyUIで完全なローカル制御が可能

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

## テンプレート

このモデルには 2 つのテンプレートワークフローが付属しています。どちらも ComfyUI **0.45.0+** とテンプレートパック **0.11.104+** が必要です。

### MiniMax-H3-Image テキストから画像生成

テキストプロンプトから画像を生成します。テンプレートは正方形のキャンバスで 4 MP で開きます。これは意図的にモデルのネイティブ解像度より低く設定されており、VRAM の少ないマシンでメモリ不足が発生しないようにしています。GPU に余裕がある場合は、解像度セレクターでサイズを上げてください。

![MiniMax-H3-Image テキストから画像生成の出力例](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_minimax_h3_image_t2i-1.webp)

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_minimax_h3_image_t2i.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「MiniMax-H3-Image: Text to Image」を検索してください

### MiniMax-H3-Image 画像編集

変更内容を記述するだけで画像を編集できます。テンプレートはソースを `<Picture 1>` として読み込み、指示から参照を認識するキャプションを構築し、最後に前後の比較ノードで仕上げます。

![MiniMax-H3-Image 画像編集の出力例](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/image_minimax_h3_image_edit-1.webp)

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/image_minimax_h3_image_edit.json)
>
> JSON をダウンロードするか、テンプレートライブラリで「MiniMax-H3-Image: Image Edit」を検索してください

**入力素材**

テンプレートにはソース画像が 1 枚付属しており、`LoadImage` ノードで `<Picture 1>` として読み込まれます。

> [card] [vintage\_yellow\_taxi.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/vintage_yellow_taxi.png)
>
> テンプレートが編集するソース画像

## モデルのダウンロード

4 つのファイルを `ComfyUI/models` に配置します。すべて Comfy-Org のミラーリポジトリから取得します。

> [card] [拡散モデル: minimax\_h3\_image\_pruned\_int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3-Image/blob/main/diffusion_models/minimax_h3_image_pruned_int8_convrot.safetensors)
>
> プルーニング済み INT8 DiT、21 GB。`ComfyUI/models/diffusion_models/` に配置

> [card] [テキストエンコーダー: qwen3vl\_32b\_minimax\_h3\_int8\_convrot.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors)
>
> Qwen3-VL-32B、INT8、25.28 GB。`ComfyUI/models/text_encoders/` に配置

> [card] [プロンプトエキスパンダー: qwen3.5\_9b\_w4a8\_gptq.safetensors](https://huggingface.co/Comfy-Org/Qwen3.5/blob/main/text_encoders/qwen3.5_9b_w4a8_gptq.safetensors)
>
> Qwen3.5 9B W4A8、7.34 GB。`ComfyUI/models/text_encoders/` に配置

> [card] [VAE: minimax\_h3\_image\_vae\_fp16.safetensors](https://huggingface.co/Comfy-Org/MiniMax-H3-Image/blob/main/vae/minimax_h3_image_vae_fp16.safetensors)
>
> 画像 VAE、FP16、1.17 GB。`ComfyUI/models/vae/` に配置

**モデルの保存場所**

```
📂 ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   └── minimax_h3_image_pruned_int8_convrot.safetensors
│   ├── 📂 text_encoders/
│   │   ├── qwen3vl_32b_minimax_h3_int8_convrot.safetensors
│   │   └── qwen3.5_9b_w4a8_gptq.safetensors
│   └── 📂 vae/
│       └── minimax_h3_image_vae_fp16.safetensors
```

## サンプリングとキャンバスサイズ

どちらのテンプレートも蒸留スケジュールを搭載しています:

| 設定 | 値 |
| - | - |
| サンプラー | euler |
| スケジューラー | simple |
| ステップ数 | 6 |
| ガイダンス（CFG） | 1 |
| デノイズ | 1 |

ガイダンスが1の場合、classifier-free guidance のパスは実行されないため、テンプレートにはネガティブプロンプトがありません。避けたい事項を含め、希望する内容はすべてポジティブプロンプトに記述してください。

ネイティブ出力は約16 MPです。各辺は32 pxの倍数で生成され、任意の幅と高さを指定できます。次のサイズは一般的な比率に対応しています:

| アスペクト比 | サイズ（幅 x 高さ） |
| - | - |
| 1:1 | 4096 x 4096 |
| 4:3 | 4736 x 3552 |
| 3:4 | 3552 x 4736 |
| 3:2 | 5024 x 3360 |
| 2:3 | 3360 x 5024 |
| 16:9 | 5472 x 3072 |
| 9:16 | 3072 x 5472 |
| 21:9 | 6272 x 2688 |

より小さいキャンバスも使用でき、所要時間も短くなります。テキストから画像へのテンプレートでは、解像度セレクターがアスペクト比と目標メガピクセル数を個別に設定するため、4 MPは上限ではなく出発点です。

## 画像編集での参照画像

画像編集テンプレートは、ソース画像を `<Picture 1>` としてモデルに送信します。追加の画像は `<Picture 2>`、`<Picture 3>` のように順番にラベル付けされ、最大16枚の参照画像まで指定できます。プロンプトはそれぞれのラベルで参照します。最初の画像が編集対象で、残りは被写体の同一性、小道具、素材、構図を補います。短い指示で十分です。たとえば、`<Picture 1>` の車両を `<Picture 2>` の車両に置き換える、といったものです。

参照画像を追加するには、ワークフローに別の `Load Image` ノードを配置し、プロンプト生成ステップと条件付けノードの両方に接続します。参照画像の準備は不要です。テンプレートはソースを32 pxの倍数に丸め、ComfyUI は内部コピーを独自にスケーリングします。ビジョン側は短辺1024 px、VAE 側は短辺を1024～2048 pxの範囲にクランプし、いずれも32 pxのグリッドに沿います。

編集時にメモリが不足する場合は、テンプレートの `Resize Image/Mask` ノードを有効にし、サンプリング前にメガピクセルを下げてください。

## プロンプトエキスパンダー

どちらのテンプレートも、サンプラーの手前にテキスト生成ステップを備えています。テキストから画像へのテンプレートでは、プロンプトを詳細な英語のキャプションに書き換え、キャンバスのアスペクト比を選択します。画像編集テンプレートでは、短い指示を、完成した画像を参照情報に基づいて説明する記述に変換します。

MiniMax-H3-Image の公式エキスパンダーは Qwen3.8-27B FP4 モデルで、[MiniMaxAI/MiniMax-H3-Image-PE](https://huggingface.co/MiniMaxAI/MiniMax-H3-Image-PE) として公開されています。テンプレートでは代わりに、より軽量な Qwen3.5 9B W4A8 ビルドを使用しているため、エキスパンダーは 21 GB の diffusion モデルと同じ GPU 上に収まります。

テキストから画像へのテンプレートはエキスパンダーがオフの状態で提供されるため、入力したプロンプトはそのままモデルに渡ります。キャプションの書き換えとアスペクト比の自動選択を行いたい場合はオンに切り替えてください。画像編集テンプレートはオンの状態で提供されます。


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