Skip to main content
MiniMax H3 は MiniMax のオープンウェイト omni-modal モデルです。テキスト、画像、ビデオ、オーディオを単一コンテキストで理解し、ネイティブステレオオーディオ付きのビデオ(音声、SFX、音楽を一体)を 1 パスで生成します。オープンウェイトは約 100 万ピクセル(短辺 768px)、24fps、最長約 15 秒が目安です。2K はホスト型サービスの出力で、ComfyUI では別途アップスケールが必要です。 ドキュメントは 6 ページに分かれています:
  • 概要(このページ): 機能、チェックポイント、ワークフロー索引、解像度、クリップ長、ステップ、サンプラー、高速化
  • ネイティブワークフロー: T2V、I2V、R2V とネイティブノードのテクニック
  • マルチフレーム参照: タイムライン上の参照フレームを固定
  • Fun ControlNet Union: コントロールビデオまたはマスクによるインペイント
  • プロンプトガイド: 公式ガイド、ヒント、埋め込み
  • FastH3: FastVideo スパースアテンションのチェックポイント
ComfyUI が最新版に更新されていることを確認してください。このガイドで紹介するワークフローは、ワークフローテンプレートから入手できます。 テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因:
  1. 最新の ComfyUI(Nightly 版)を使用していない
  2. 起動時に一部のノードのインポートに失敗している
H3 のオープンウェイトはローカルで実行できます。ローカル生成した出力を商用利用するには、唯一の公式販売代理店である Comfy を通じて MiniMax 商用ライセンス が必要です。Comfy Cloud 上の生成にはすでに商用利用権が含まれています。ティアと料金は 商用ライセンス を参照してください。

主な機能

  • ネイティブステレオオーディオ: 会話、SFX、音楽を 1 つの MP4 に
  • マルチモーダルコンテキスト: テキスト、画像、ビデオ、オーディオ参照を組み合わせ
  • 参照駆動生成: 参照からアイデンティティ、スタイル、モーション、カメラ、声を固定
  • 指示への追従: 参照とショットの関係を自然言語で記述
  • 正確なテキストレンダリング: 綴りとブランド要素をクリアに
  • オープンウェイト: ComfyUI でローカルにフル制御

はじめに

  1. ComfyUI を更新: 基本 T2V/I2V/R2V テンプレートは 0.30.0+、マルチフレーム参照 0.34.0+、Fun ControlNet Union・スパースアテンション・Model Attention Backend 0.35.0+、FastH3 0.36.0+
  2. テンプレートライブラリ > ビデオ > MiniMax H3 ワークフローを選択
  3. ポップアップからモデルをダウンロード(数十 GB、時間とディスクを確保)
ウェイトは Comfy-Org/MiniMax-H3 にあります。
フルと pruned の両方がある場合は pruned を使います。pruned は adaln を共有カーブ表(adaln_t_table)に置き、ComfyUI はファイルから読み取ります。テンプレートは minimax_h3_*_pruned_int8_convrot.safetensors を読み込みます。フルビルドで蒸留した LoRA の adaln テンソルは pruned に無く(形状不一致でスキップ)。Turbo LoRA に adaln はなく、どちらのビルドでも可。

チェックポイント精度の選択

VRAM に収まる最小ビルドを選びます。UNETLoader のファイルだけ変更すればよく、量子化は checkpoint から読み取られます。LoRA はビルド系列に合わせます(フルビルド LoRA は pruned で adaln を失います)。 リンクは T2V/I2V の fl2va です。ref2va は同フォルダ・同サイズ。Comfy Kitchen attention は int8_convrot checkpoint を実行できません。そのバックエンドでは bf16 を選んでください。 VRAM が足りない場合は 1 段下げます。CPU offload は精度より遅いです。RTX 30 系では INT8 行列が FP16 の約 2×で FP8 経路がないため、同サイズでは INT8 が FP8 より速いことが多いです。 動画・音声 VAE も必要です: 動画 fp16 / int8_convrot と 音声 fp32。テンプレートは int8 動画 + fp32 音声; int8 動画は ComfyUI 0.36.0+ でデコード約 2×。拡散モデルと同様に VAELoader で差し替えます。

ワークフロー索引

テンプレートは現在 6 例(網羅的ではありません)。I2V 続きの変体(video_minimax_h3_i2v_continuation)もあります。

テキストから動画へ(T2V)

テキストプロンプトから、ネイティブのステレオオーディオ付きビデオを生成します。

画像から動画へ(I2V)

入力画像からビデオを生成します。先頭・末尾フレームの制御もオプションで指定できます。

参照から動画へ(R2V)

参照画像、ビデオ、オーディオから、キャラクター、スタイル、モーション、カメラワーク、または音声を固定します。

マルチフレーム参照

Add Guideノードを連結して、出力タイムライン上の特定のポイントに参照フレームを固定します。

Fun ControlNet Union

Canny、Depth、HED、MLSD、またはPoseのコントロールビデオでH3を駆動するか、マスクを使用してビデオインペインティングを実行できます。
MiniMax H3 Image to Video が T2V と先頭/末尾フレーム I2V(t2va / fl2va)を、MiniMax H3 Reference to Video が R2V(ref2va)を担当します。
参照条件はサンプラーに届いたときだけ効きます。T2V/I2V テンプレートはサブグラフ内で Image to Video のみにサンプルします。キャンバスの Reference to Video はエラーなく無視されます。参照駆動には R2V テンプレート(またはそれを基にしたワークフロー)を使ってください。
プロンプト: プロンプトガイド。

出力解像度の設定

Resolution Selector が H3 ノードの width / height を設定します:
  • Aspect ratio: 16:9 (Widescreen)、9:16 (Portrait Widescreen)、1:1 (Square) など
  • Megapixels: 総ピクセル(大きいほど遅い)
  • Multiple: グリッド丸め; H3 は 32 のまま
テンプレートの Megapixels は既定で 0.4 です。16:9 では 864×480、1:1 では 640×640(I2V の既定)。0.4 MP は高速で下書き向けなので、最終出力の前に Megapixels を上げてください。 16:9 ネイティブ品質: 0.98(約 1344×768)またはノードに 1344 × 768。1.0 MP(1376×768)は 768×1344 上限超過。学習は約 1 MP; 過大キャンバスは詳細を増やしません。2K はネイティブ生成後に別途アップスケール。

高解像度へのアップスケール

24 チャンネル動画 latent の latent アップスケーラーで VAE 往復のゴーストを避けます。Minimax_h3_latent_Upscaler(非公式)は 重み と カスタムノード が必要です。低解像度生成後 Minimax H3 Latent Upscaler (3D)(scale 1.0–4.0、既定 2.0)を挟み、目標解像度で再サンプル。 Latent アップスケールは時間を節約し、ピーク VRAM は節約しません。仕上げは部分デノイズ: denoise 0.1–0.5 で構図維持; 大きく作り直すときだけ上げます。仕上げサンプラーは多段履歴の再構築に十分なステップを(「サンプラーとスケジューラ」参照)。 動画 latent(24)と音声 latent(32)は別です。アップスケーラーは動画空間のみ拡大; 仕上げで両方デノイズ。低 denoise で初回音声を保持。完全一致なら仕上げ前に VAEDecodeAudio で初回音声をデコードし最終 CreateVideo に接続(SaveAudioAdvanced でロスレス出力可)。

クリップの長さ

H3 は短クリップで学習; ネイティブノードは広い範囲を受け付け、過長もブロックしません。 テンプレートは秒の duration を 24fps で 17k+5 フレームに変換します。 満解像度の長クリップは先に VRAM を使い切ります。Megapixels を下げて収めます。

クリップの連結

学習範囲超えは I2V 続きで各クリップの最終フレームから。誤差は累積(顔テクスチャが先に劣化); turbo/蒸留は早く「焼け」ます。 video_minimax_h3_i2v_continuation(空プロンプト): 最終フレームを読み込み次区間を記述。連続ショットは短く、焼け前にカット。長い連鎖では初回以降 H3-Anti-Burn-LoRA を strength_model 約 0.5(続き方に合わせて調整)。

ステップ数

既定(Lightning LoRA オフ): 20 ステップ。turbo オン: T2V/I2V(続き含む)8、R2V・マルチフレーム・Fun ControlNet 4。T2V/I2V サブグラフは turbo_mode、turbo_steps、turbo_model_strength。4 ステップ fl2va: minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors、turbo_steps 4。 参照ショットはステップ多め: 参照トークンは毎ステップ; 4 ステップ turbo は参照がほぼ乗らず(ポーズ/顔ドリフト)。厳密な参照一致では turbo オフまたは 25 付近。 蒸留スケジュールは 20 ステップ基線より細部が滑らか。各 turbo ファイルはモード別; スタイル LoRA を重ねる前に固定シードで試験。turbo_steps 増 + turbo_model_strength 低下(<1)で基線品質に近づき時間増。例: 4 ステップファイルを 6–8 ステップ、強度約 0.8。 Turbo は schedule を短くするだけで 1 ステップは速くなりません(読み込み時マージ)。4 ステップ LoRA を 20 ステップ回すと基線 20 と同程度の時間。 内容別:
  • 単純ショット: 12–16 ステップで足りることが多い
  • 高周波詳細(チェインメイル、フィリグリー、小物体多数): 約 50 まで改善; それ未満は動き中の三角グリッドアーティファクト(turbo で悪化)
  • モーション/プロンプトの大半は 16 ステップまで; 50 以降は差が小さい
  • ネイティブ解像度のソフトさは多くが解像度問題
音声は共同デノイズで映像より収束が遅い。音声・音色は 12+ ステップ; 8 では音声が弱いことが多い。

サンプラーとスケジューラ

テンプレートは res_multistep + simple。T2V/I2V/FastH3 はサブグラフ内; R2V、マルチフレーム、Fun ControlNet はキャンバスに KSamplerSelect と BasicScheduler。 res_multistep は 2 次多段(初ステップは Euler)。2 サンプラーに分割すると多段履歴が失われ、2 番目の初ステップは再び 1 次。1 回のサンプル実行にまとめるか、2 番目に十分なステップでウォームアップ。 既定 shift: 12、audio_shift: 3(モデル定義)。FastH3 テンプレート ModelSamplingMiniMaxH3 は shift_video 10、shift_audio 3。蒸留ビルドで video shift 誤り(8 ステップで 3 而非 10)はグリッドアーティファクト。DMAD 4-step LoRA は shift 12、audio_shift 2、lcm + simple。

Sage Attention で生成を高速化

Sage Attention で約 2× 加速、画質影響は小さいことが多い(任意インストール):
  1. releases から PyTorch/CUDA 一致 wheel を pip install
  2. KJNodes の Patch Sage Attention KJ
  3. UNETLoader と BasicGuider の間、sage_attention を auto
  4. または --use-sage-attention
一部 H3 層は float16/bfloat16 外で PyTorch attention にフォールバック(コンソール警告は正常)。

INT8 アテンションによる品質劣化

クリップ終盤のモーフや画面文字化けは INT8 attention 量子化が原因のことが多い。
  • テンプレートは int8_convrot。Comfy Kitchen は非対応(issue #15529)。既定 attention か pruned_bf16 に替えてからバックエンド変更。
  • bf16 では Comfy Kitchen attention(量子化前チャンネル回転)が同程度速度でアーティファクト解消。
BasicGuider へのモデル経路に Model Attention Backend(comfy kitchen attention)、または --use-ck-attention(0.32.0+)。ハードウェアで comfy-kitchen INT8 カーネルが必要。

スパースアテンションによる生成の高速化

Model Sparse Attention(0.35.0+、実験的)が長クリップの attention コストを削減。ベース H3 は sol-attn(sla/vsa は対応ウェイト必要)。CUDA + comfy-kitchen の sol_attn、なければ dense のまま。
  • 既定 start_percent 0.2、end_percent 1.0。約 0.4 開始・0.9 終了で首尾フレーム保護。
  • H3 は sink_conditioning を exact_kv_and_rows のまま。
  • tau: 大きいほど疎/速(1.0 約 16% 正確ブロック、1.3 既定、2.0 約 2.7%)。
  • min_tokens(既定 12288)未満は効果小。
FastH3 は vsa、keep_percent 10; FastH3 ページ。

商用ライセンス

H3 のオープンウェイトは無料でダウンロードして実行できます。ローカル生成した出力を商用利用するには、唯一の公式販売代理店である Comfy を通じて販売される MiniMax 商用ライセンス が必要です。Comfy Cloud 上の生成にはすでに商用利用権が含まれているため、ライセンスが必要になるのはローカル利用の場合のみです。 ライセンスは必要ですか?
  • Comfy Cloud:商用利用が含まれています。購入は不要です。
  • 米国、EU、英国、韓国以外で自社ハードウェア上で実行し、年間売上が 2,000 万米ドル未満:MiniMax の無料コミュニティライセンスで商用利用がカバーされます。“Powered by MiniMax H3” のクレジットを表示してください。同じ地域ルールは出力の利用地にも適用されます。
  • 米国、EU、英国、韓国で自社ハードウェア上で実行する、または年間売上が 2,000 万米ドル超:以下の 2 つのライセンスのいずれかが必要です。
ライセンスは 2 つのティアがあります: Professional は月額 $5,000 からです。Enterprise には定価がなく、生成量とチーム規模に応じて見積もります。いずれのティアも、1 つの契約で MiniMax H3 と MiniMax Audio & Music をカバーします。ライセンスをリクエスト して見積もりを取得してください。