> ## 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.

# ComfyUI MiniMax H3 Fun ControlNet Union: 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)

<CardGroup cols={2}>
  <Card title="Comfy Cloud で実行" icon="cloud" href="https://cloud.comfy.org/?template=video_minimax_h3_fun_controlnet_union&utm_source=docs&utm_medium=referral&utm_campaign=minimax-h3">
    Comfy Cloud で開く
  </Card>

  <Card title="ワークフローをダウンロード" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/video_minimax_h3_fun_controlnet_union.json">
    JSON をダウンロードするか、テンプレートライブラリで「MiniMax H3 Fun ControlNet Union」を検索してください
  </Card>
</CardGroup>

**入力素材**

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

<CardGroup cols={2}>
  <Card title="dancer_field_pose.mp4" icon="video" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/dancer_field_pose.mp4">
    サンプルワークフローで使用するポーズコントロールビデオです。独自のビデオを使用することもできます。
  </Card>
</CardGroup>

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

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

<CardGroup cols={2}>
  <Card title="Diffusionモデル: minimax_h3_ref2va_pruned_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors">
    <code>ComfyUI/models/diffusion\_models/</code> に配置してください
  </Card>

  <Card title="ControlNetパッチ: minimax_h3_fun_controlnet_union_pruned_int8_convrot" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/model_patches/minimax_h3_fun_controlnet_union_pruned_int8_convrot.safetensors">
    <code>ComfyUI/models/model\_patches/</code> に配置してください
  </Card>

  <Card title="テキストエンコーダー: qwen3vl_32b_minimax_h3_nvfp4_awq" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors">
    <code>ComfyUI/models/text\_encoders/</code> に配置してください
  </Card>

  <Card title="VAE: minimax_h3_video_vae_fp16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_video_vae_fp16.safetensors">
    <code>ComfyUI/models/vae/</code> に配置してください
  </Card>

  <Card title="VAE: minimax_h3_audio_vae_fp32" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/vae/minimax_h3_audio_vae_fp32.safetensors">
    <code>ComfyUI/models/vae/</code> に配置してください
  </Card>

  <Card title="LoRA: minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16" icon="download" href="https://huggingface.co/Comfy-Org/MiniMax-H3/blob/main/loras/minimax_h3_ref2v_turbo_4step_v0.1_comfyui_bf16.safetensors">
    オプションのLightning LoRAターボモードを有効にします。<code>ComfyUI/models/loras/</code> に配置してください
  </Card>

  <Card title="チェックポイント: sdpose_wholebody_fp16" icon="download" href="https://huggingface.co/Comfy-Org/SDPose/blob/main/checkpoints/sdpose_wholebody_fp16.safetensors">
    組み込みのSDPoseサブグラフで使用されるポーズ抽出器です。<code>ComfyUI/models/checkpoints/</code> に配置してください
  </Card>

  <Card title="検出器: rt_detr_v4-x-hgnet_fp16" icon="download" href="https://huggingface.co/Comfy-Org/SDPose/blob/main/diffusion_models/rt_detr_v4-x-hgnet_fp16.safetensors">
    組み込みのSDPoseサブグラフで使用される人物検出器です。<code>ComfyUI/models/diffusion\_models/</code> に配置してください
  </Card>
</CardGroup>

## モデルの保存先

```
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_fp16.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)、深度マップについては [Depth Anything 3 チュートリアル](https://docs.comfy.org/tutorials/utility/depth-anything-3) を参照してください。
