> ## 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를 conditioning하는 단일 checkpoint이며, 마스크를 사용한 비디오 inpainting도 실행합니다. `fl2va` 및 `ref2va` transformer 파일 모두에서 작동합니다.

![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>

**입력 자료**

이 파일을 해당 `비디오 불러오기` 노드에 업로드하세요:

<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">
    예제 워크플로에서 사용되는 Pose 제어 비디오입니다. 또는 직접 준비한 비디오를 사용해도 됩니다.
  </Card>
</CardGroup>

이 템플릿은 ComfyUI 0.35.0 이상이 필요합니다. 예제는 Pose 제어 비디오를 사용합니다. 기본 제공 SDPose 서브그래프가 입력 비디오에서 Pose 스켈레톤을 추출하므로, 출력이 댄서의 움직임을 재현합니다. 또한 사전 처리된 제어 비디오를 `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)을 참조하세요.