MiniMax H3 Prompt Builder 1.8.0: ComfyUI でのマスク付きクリップ編集

パックに同梱されているリファレンスモードのチェーン: Media Loader → Prompt Builder → MiniMax H3 Reference to Video。

マスク付きクリップ編集

バージョン 1.8.0 は、H3 ユーザーが繰り返し直面する課題に答えます。クリップ内の 1 か所だけを変更し、残りの映像には手を加えないことです。マスクがモデルの変更を許可する場所を決め、プロンプトがその領域が何になるかを決めます。

Media Loader でクリップを右クリックし、Mask for editing を選ぶとマスクタブが開きます。これは現在のトリム、クロップ、ミラー状態のクリップに対して機能します。マスクは画像エディタのようにレイヤーを重ねて作成し、新しいレイヤーごとにその領域を Add するか、下のレイヤーから Cut して切り抜くかを選べます。

• Auto Mask with SAM はプロンプトとドットでマスクします。クリアなフレーム上で対象をクリックし、除外したいものは右クリックし、それが何かを入力（「緑のジャケット」）すると、ドットの下のその部分だけがマスクされます。複数のフレームで実行すると、マークした各フレームでトラッキングが再シードされ、これがドリフトするマスクを修復する方法です。
• Ellipse、Rectangle、Polygon レイヤーは手描きで作成し、キーフレームを打ちます。別のフレームで移動またはリサイズすると被写体を追従し、補間は Smooth、Linear、Ease から選べ、フレームから外れるオブジェクト用に Hidden キーもあります。
• Brush は 1 フレームに対して、現在位置から最後まで、またはクリップ全体に対して描画または消去します。

Use this mask は保持範囲でレイヤーを結合し、編集可能な状態を保つためクリップと一緒に保存します。カードには Video 1 · editing と表示されます。グラフ側では、RefMod Text Encode が編集を構築し、新しい Fantastic H3 Edit Composite ノードが再生成された領域だけを元のフレームに貼り戻すので、マスク外のすべては撮影どおりのまま残ります。

マスク機能のパスには、models/checkpoints に SAM 3.1 チェックポイント sam3.1_multiplex_fp16.safetensors が必要です。このパックが自動でダウンロードすることはありません。

RefMod ライブラリ: 再利用可能なリファレンスバンドルの作成、編集、整理、タグ付けを行います。

高速化された RefMod エンコード

RefMod は、テキストエンコーダーに渡す画像を自身のファイル内に保持するようになったため、エンコーダーは実行のたびにそれらをデコードしなくなりました。古い RefMod は一度デコードされてキャッシュされ、ライブラリの Store encoder frames アクションでそのフレームを古いファイルに恒久的に書き込めます。

Text Encode の新しい実験的な stack_pictures 設定では、RefMod の画像のうち何枚をエンコーダーに渡すかを選べます。4 枚ごと（以前の動作）、最大 8 枚、またはすべてです。より多くを見せることで、複数の RefMod 間の同一性やにじみの改善に役立つことがありますが、メモリと生成時間のコストがかかります。

1.8.0 のその他の変更

トリムとクロップのエディタは、クリップからフレームを直接画像リファレンスプールに取り出すのにも使われます。

• トリムエディタにタイムラインズーム、再生ヘッドが最初の保持フレームよりどれだけ先にあるかの表示、閉じる前の未保存変更の確認、背後にあるグラフに届かなくなった Ctrl+Z が追加されました。
• 任意のビルダーフィールドで選択したテキストを右クリックすると、Copy、Cut、Paste、Remove が「save selection as phrase」と並んで表示されるようになりました。
• Media Loader の Clean up は、どこからも使われていないマスクファイルと古くなった保存済み latent を削除し、保存済みメディアセットやドラフトからまだ参照されているマスクは保持し、未使用のマスクが 500 MB を超えると提案を表示します。
• voice_description_at_label は、各ボイス RefMod の保存済み説明をその <Audio n>: ラベルの直後に書き込みます。
• 新しい RefMod の短辺のデフォルトは、1024 px ではなく 768 px になりました。
• 内蔵ガイドにマスク編集に関する Part E が追加され、README のリリースノートは別の CHANGELOG.md に移動しました。

インストール

このパックには ComfyUI 0.30.0 以降 と、通常の H3 チェックポイントが必要です。テキストとキーフレーム作業には fl2va、リファレンスモードには ref2va を使います。映像と音声のデコードは PyAV を経由しますが、正常に動作する ComfyUI 環境にはすでに含まれています。

cd ComfyUI/custom_nodes
git clone https://github.com/Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder

その後 ComfyUI を完全に再起動し、ノードメニューで MiniMax H3 を検索してください。このパックは ComfyUI Manager から「Fantastic H3 Prompt Builder」で検索してインストールすることもできます。

リポジトリ: Adudeguyman/ComfyUI-Fantastic-MiniMaxH3-PromptBuilder
RefMods ガイド: REFMODS.md
変更履歴: CHANGELOG.md
ベースモデル: Comfy-Org/MiniMax-H3