> ## 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 Fun ControlNet Union: ComfyUI Pose・Depth・Canny 制御ビデオ

> Canny、Depth、HED、MLSD、Pose のコントロールビデオで ComfyUI の MiniMax H3 動画の動きを制御し、Fun ControlNet Union パッチでマスクベースのインペインティングも行えます。

テキストだけでなく、コントロールビデオを使って MiniMax H3 ビデオのモーションを制御できます。Fun ControlNet Union パッチ（[alibaba-pai/MiniMax-H3-Fun-Controlnet-Union](https://huggingface.co/alibaba-pai/MiniMax-H3-Fun-Controlnet-Union)、[Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3) に同梱）は、Canny、Depth、HED、MLSD、Pose のいずれかのコントロールビデオを条件として H3 を制御する単一の checkpoint で、マスクを使用したビデオインペインティングも実行できます。`fl2va` と `ref2va` の両方のトランスフォーマーファイルで動作します。

![MiniMax H3 Fun ControlNet Union ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/video_minimax_h3_fun_controlnet_union-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=video_minimax_h3_fun_controlnet_union\&utm_source=docs\&utm_medium=referral\&utm_campaign=minimax-h3)
>
> Comfy Cloud で開く

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

**入力素材**

このファイルを、対応する `Load Video` ノードにアップロードしてください：

> [card] [dancer\_field\_pose.mp4](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/dancer_field_pose.mp4)
>
> サンプルワークフローで使用するポーズコントロールビデオです。独自のビデオを使用することもできます。

このテンプレートには ComfyUI 0.35.0 以降が必要です。この例ではポーズコントロールビデオを使用しています。組み込みの SDPose サブグラフが入力ビデオからポーズスケルトンを抽出するため、出力はダンサーのモーションを再現します。また、前処理済みの任意のコントロールビデオを、`Apply MiniMax H3 Fun ControlNet` ノードの `control_video` 入力に直接接続することもできます。

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

> [card] [Diffusionモデル: minimax\_h3\_ref2va\_pruned\_int8\_convrot](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors)
>
> `ComfyUI/models/diffusion_models/` に配置してください

> [card] [ControlNetパッチ: minimax\_h3\_fun\_controlnet\_union\_pruned\_int8\_convrot](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/model_patches/minimax_h3_fun_controlnet_union_pruned_int8_convrot.safetensors)
>
> `ComfyUI/models/model_patches/` に配置してください

> [card] [テキストエンコーダー: qwen3vl\_32b\_minimax\_h3\_nvfp4\_awq](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors)
>
> `ComfyUI/models/text_encoders/` に配置してください

> [card] [VAE: minimax\_h3\_video\_vae\_int8\_convrot](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_video_vae_int8_convrot.safetensors)
>
> `ComfyUI/models/vae/` に配置してください

> [card] [VAE: minimax\_h3\_audio\_vae\_fp32](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_audio_vae_fp32.safetensors)
>
> `ComfyUI/models/vae/` に配置してください

> [card] [LoRA: minimax\_h3\_ref2v\_turbo\_4step\_v0.1\_comfyui\_bf16](https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/loras/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors)
>
> オプションのLightning LoRAターボモードを有効にします。`ComfyUI/models/loras/` に配置してください

> [card] [チェックポイント: sdpose\_wholebody\_fp16](https://huggingface.co/Comfy-Org/SDPose/blob/main/checkpoints/sdpose_wholebody_fp16.safetensors)
>
> 組み込みのSDPoseサブグラフで使用されるポーズ抽出器です。`ComfyUI/models/checkpoints/` に配置してください

> [card] [検出器: rt\_detr\_v4-x-hgnet\_fp16](https://huggingface.co/Comfy-Org/SDPose/blob/main/diffusion_models/rt_detr_v4-x-hgnet_fp16.safetensors)
>
> 組み込みのSDPoseサブグラフで使用される人物検出器です。`ComfyUI/models/diffusion_models/` に配置してください

## モデルの保存先

```
ComfyUI/
├── 📂 models/
│   ├── 📂 diffusion_models/
│   │   ├── minimax_h3_ref2va_pruned_int8_convrot.safetensors
│   │   └── rt_detr_v4-x-hgnet_fp16.safetensors
│   ├── 📂 text_encoders/
│   │   └── qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
│   ├── 📂 vae/
│   │   ├── minimax_h3_video_vae_int8_convrot.safetensors
│   │   └── minimax_h3_audio_vae_fp32.safetensors
│   ├── 📂 loras/
│   │   └── minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors
│   ├── 📂 model_patches/
│   │   └── minimax_h3_fun_controlnet_union_pruned_int8_convrot.safetensors
│   └── 📂 checkpoints/
│       └── sdpose_wholebody_fp16.safetensors
```

## プロンプトのヒント

1. **ビデオの長さ**: 対象のビデオは、24fps の 17n+5 フレームグリッド上で5〜15秒間実行されます(124フレーム = 5秒)。対象より長いコントロールビデオは最初のフレームで切り詰められ、短い場合は最後のフレームが保持されます。コントロールビデオの長さに正確に一致させるには、サンプルで計算された `batch_size` 出力を `MiniMax H3 Reference to Video` ノードの長さ入力にリンクしてください。
2. **ガイダンスと強度**: `guidance_scale` は 1.0 に保ってください。出力がコントロールから逸脱した場合にのみ、パッチの `strength` を 1 より上げてください。
3. **ビデオインペインティング**: マスクを `mask` 入力に接続します。`1` とマークされた領域は、オプションの `source_video` 入力の制御下で再生成され、フレームの残りの部分は固定されたままになります。
4. **ターボモード(オプション)**: **Lightning LoRA** チェックボックスを有効にすると、4ステップのターボ LoRA を使用して生成が大幅に高速化されます(オーディオとモーションの品質は若干低下します)。
5. **コントロールビデオの準備**: ComfyUI には、各コントロールタイプ用の組み込みの前処理ノードが同梱されています。エッジについては [Detect Edges (Canny) ノード](https://docs.comfy.org/built-in-nodes/Canny.md)、深度マップについては [Depth Anything 3 チュートリアル](https://docs.comfy.org/tutorials/utility/depth-anything-3.md) を参照してください。


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