> ## 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 Hunyuan3D-2 예시

> 이 가이드에서는 ComfyUI에서 Hunyuan3D-2를 사용해 3D 자산을 생성하는 방법을 보여드립니다.

# Hunyuan3D 2.0 소개

![Hunyuan 3D 2](https://raw.githubusercontent.com/Tencent/Hunyuan3D-2/main/assets/images/e2e-1.gif)
![Hunyuan 3D 2](https://raw.githubusercontent.com/Tencent/Hunyuan3D-2/main/assets/images/e2e-2.gif)
[Hunyuan3D 2.0](https://github.com/Tencent/Hunyuan3D-2)은 텐센트가 공개한 오픈소스 3D 자산 생성 모델로, 텍스트나 이미지를 통해 고해상도 텍스처 맵을 갖춘 고화질 3D 모델을 생성할 수 있습니다.

Hunyuan3D 2.0은 두 단계의 생성 방식을 채택하며, 먼저 텍스처 없는 기하학적 모델을 생성한 후 고해상도 텍스처 맵을 합성합니다. 이를 통해 형태와 텍스처 생성의 복잡성을 효과적으로 분리했습니다. 아래는 Hunyuan3D 2.0의 두 가지 핵심 구성 요소입니다:

1. **기하학적 생성 모델(Hunyuan3D-DiT)**: 플로우 확산 트랜스포머 아키텍처를 기반으로 하며, 입력 조건과 정확히 일치하는 텍스처 없는 기하학적 모델을 생성합니다.
2. **텍스처 생성 모델(Hunyuan3D-Paint)**: 기하학적 조건과 다중뷰 확산 기법을 결합해 모델에 고해상도 텍스처를 추가하며, PBR 재료를 지원합니다.

**주요 장점**

* **고정밀 생성**: 선명한 기하학적 구조, 풍부한 텍스처 색상, PBR 재료 생성 지원으로 사실에 가까운 라이팅 효과를 구현합니다.
* **다양한 활용 방식**: 코드 호출, 블렌더 플러그인, Gradio 애플리케이션 및 공식 웹사이트를 통한 온라인 체험을 제공해 다양한 사용자 요구에 적합합니다.
* **경량성과 호환성**: Hunyuan3D-2mini 모델은 VRAM 5GB만 필요하며, 표준 버전은 형상 생성에 VRAM 6GB, 전체 과정(형상 + 텍스처)에는 VRAM 12GB만 필요합니다.

최근(2025년 3월 18일), Hunyuan3D 2.0은 다중뷰 형상 생성 모델(Hunyuan3D-2mv)도 도입했으며, 이는 서로 다른 각도에서 입력된 데이터로부터 더욱 세밀한 기하학적 구조를 생성하도록 지원합니다.

이 예시에는 세 가지 워크플로우가 포함되어 있습니다:

* 다중뷰 입력을 사용해 3D 모델을 생성하는 Hunyuan3D-2mv 사용법
* 다중뷰 입력을 사용해 3D 모델을 생성하는 Hunyuan3D-2mv-turbo 사용법
* 단일뷰 입력을 사용해 3D 모델을 생성하는 Hunyuan3D-2 사용법

<Tip>
  ComfyUI는 현재 Hunyuan3D-2mv를 기본적으로 지원하지만, 텍스처 및 재료 생성은 아직 지원하지 않습니다. 시작하기 전에 [ComfyUI](https://github.com/Comfy-Org/ComfyUI)의 최신 버전으로 업데이트되었는지 확인해 주세요.

  이 튜토리얼의 워크플로우 예시 PNG 이미지는 메타데이터에 워크플로우 JSON을 포함하고 있습니다:

  * 직접 ComfyUI로 드래그할 수 있습니다.
  * 또는 메뉴 `Workflows` -> `Open (ctrl+o)`를 사용하세요.

  이렇게 하면 해당 워크플로우가 로드되고 필요한 모델을 다운로드하라는 메시지가 표시됩니다. 생성된 `.glb` 형식의 모델은 `ComfyUI/output/mesh` 폴더에 출력됩니다.
</Tip>

## ComfyUI Hunyuan3D-2mv 워크플로우 예시

Hunyuan3D-2mv 워크플로우에서는 다중뷰 이미지를 사용해 3D 모델을 생성합니다. 이 워크플로우에서는 다중뷰 이미지가 필수는 아니며, `front` 뷰 이미지만 사용해도 3D 모델을 생성할 수 있습니다.

<Tip>
  <Tabs>
    <Tab title="휴대용 또는 자체 배포 사용자">
      ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

      * [ComfyUI 다운로드](https://www.comfy.org/download)
      * [업데이트 가이드](/ko/installation/update_comfyui)

      이 가이드의 워크플로우는 [워크플로우 템플릿](/ko/interface/features/template)에서 확인할 수 있습니다.
      템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다. (데스크톱 버전의 업데이트는 다소 지연될 수 있습니다)

      워크플로우를 로드할 때 노드가 누락되는 경우, 가능한 원인:

      1. 최신 ComfyUI 버전(야간 빌드)을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="데스크톱 또는 클라우드 사용자">
      * 데스크톱 버전은 ComfyUI 안정판 기반으로, 새로운 데스크톱 안정판이 출시되면 자동으로 업데이트됩니다.
      * [클라우드](https://cloud.comfy.org)는 ComfyUI 안정판 출시 후 업데이트됩니다.

      따라서 이 문서에서 핵심 노드가 누락된 것을 발견했다면, 그 이유는 새로운 핵심 노드가 아직 최신 안정판에 공개되지 않았기 때문일 수 있습니다. 다음 안정판 출시를 기다려 주세요.
    </Tab>
  </Tabs>
</Tip>

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Comfy Cloud에서 실행</p>
</a>

### 1. 워크플로우

아래 이미지를 다운로드해 ComfyUI로 드래그하여 워크플로우를 로드해 주세요.
![Hunyuan3D-2mv 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/hunyuan-3d-multiview-elf.webp)

아래 이미지를 다운로드해 입력 이미지로 사용해 주세요.

![입력 이미지](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/front.png)
![입력 이미지](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/left.png)
![입력 이미지](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/back.png)

<Tip>
  이 예시에서 사용된 입력 이미지는 이미 사전 처리되어 불필요한 배경이 제거되었습니다. 실제 사용 시, [ComfyUI\_essentials](https://github.com/cubiq/ComfyUI_essentials)와 같은 커스텀 노드를 사용해 자동으로 불필요한 배경을 제거할 수 있습니다.
</Tip>

### 2. 수동 모델 설치

아래 모델을 다운로드해 해당 ComfyUI 폴더에 저장해 주세요.

* hunyuan3d-dit-v2-mv: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2mv/resolve/main/hunyuan3d-dit-v2-mv/model.fp16.safetensors?download=true) - 다운로드 후 `hunyuan3d-dit-v2-mv.safetensors`로 이름을 변경할 수 있습니다.

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv.safetensors  // 이름 변경된 파일
```

### 3. 워크플로우 실행 단계

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=17e6ac738f0e0133536bceb6e3ea1b56" alt="ComfyUI hunyuan3d_2mv" width="3000" height="1618" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv.jpg" />

1. 이미지 전용 체크포인트 로더(img2vid 모델)가 다운로드하고 이름을 변경한 `hunyuan3d-dit-v2-mv.safetensors` 모델을 로드했는지 확인하세요.
2. 각 `Load Image` 노드에 해당 뷰 이미지를 로드하세요.
3. `Queue` 버튼을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용해 워크플로우를 실행하세요.

뷰를 더 추가해야 하는 경우, `Hunyuan3Dv2ConditioningMultiView` 노드에 다른 뷰 이미지를 로드하고, `Load Image` 노드에도 해당 뷰 이미지를 로드했는지 확인하세요.

## Hunyuan3D-2mv-turbo 워크플로우

Hunyuan3D-2mv-turbo 워크플로우에서는 Hunyuan3D-2mv-turbo 모델을 사용해 3D 모델을 생성합니다. 이 모델은 Hunyuan3D-2mv의 단계 증류 버전으로, 더 빠른 3D 모델 생성을 가능하게 합니다. 이번 버전의 워크플로우에서는 `cfg`를 1.0으로 설정하고, `flux guidance` 노드를 추가해 `증류된 cfg` 생성을 제어합니다.

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model_turbo&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Comfy Cloud에서 실행</p>
</a>

### 1. 워크플로우

아래 이미지를 다운로드해 ComfyUI로 드래그하여 워크플로우를 로드해 주세요.

![Hunyuan3D-2mv-turbo 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp)

아래 이미지를 다운로드해 입력 이미지로 사용해 주세요.

![입력 이미지](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png)
![입력 이미지](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/right.png)

### 2. 수동 모델 설치

아래 모델을 다운로드해 해당 ComfyUI 폴더에 저장해 주세요.

* hunyuan3d-dit-v2-mv-turbo: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2mv/resolve/main/hunyuan3d-dit-v2-mv-turbo/model.fp16.safetensors?download=true) - 다운로드 후 `hunyuan3d-dit-v2-mv-turbo.safetensors`로 이름을 변경할 수 있습니다.

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv-turbo.safetensors  // 이름 변경된 파일
```

### 3. 워크플로우 실행 단계

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv_turbo.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=33bb861fd695fd4b10a53345f004d2cc" alt="ComfyUI hunyuan3d_2mv_turbo" width="3000" height="1621" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv_turbo.jpg" />

1. `Image Only Checkpoint Loader(img2vid 모델)` 노드가 이름을 변경한 `hunyuan3d-dit-v2-mv-turbo.safetensors` 모델을 로드했는지 확인하세요.
2. 각 `Load Image` 노드에 해당 뷰 이미지를 로드하세요.
3. `Queue` 버튼을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용해 워크플로우를 실행하세요.

## Hunyuan3D-2 단일뷰 워크플로우

Hunyuan3D-2 워크플로우에서는 Hunyuan3D-2 모델을 사용해 3D 모델을 생성합니다. 이 모델은 다중뷰 모델이 아닙니다. 이번 워크플로우에서는 `Hunyuan3Dv2ConditioningMultiView` 노드 대신 `Hunyuan3Dv2Conditioning` 노드를 사용합니다.

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_image_to_model&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Comfy Cloud에서 실행</p>
</a>

### 1. 워크플로우

아래 이미지를 다운로드해 ComfyUI로 드래그하여 워크플로우를 로드해 주세요.

![Hunyuan3D-2 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d-non-multiview-train.webp)

아래 이미지를 다운로드해 입력 이미지로 사용해 주세요.
![ComfyUI Hunyuan 3D 2 워크플로우](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan_3d_v2_non_multiview_train.png)

### 2. 수동 모델 설치

아래 모델을 다운로드해 해당 ComfyUI 폴더에 저장해 주세요.

* hunyuan3d-dit-v2-0: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2/resolve/main/hunyuan3d-dit-v2-0/model.fp16.safetensors?download=true) - 다운로드 후 `hunyuan3d-dit-v2.safetensors`로 이름을 변경할 수 있습니다.

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2.safetensors  // 이름 변경된 파일
```

### 3. 워크플로우 실행 단계

<img src="https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg?fit=max&auto=format&n=NmGUk_QSXQXRVtZP&q=85&s=33c158fcfb133560674aa56bfdb5087d" alt="ComfyUI hunyuan3d_2" width="3000" height="1624" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg" />

1. `Image Only Checkpoint Loader(img2vid 모델)` 노드가 이름을 변경한 `hunyuan3d-dit-v2.safetensors` 모델을 로드했는지 확인하세요.
2. `Load Image` 노드에 이미지를 로드하세요.
3. `Queue` 버튼을 클릭하거나 단축키 `Ctrl(cmd) + Enter`를 사용해 워크플로우를 실행하세요.

## 커뮤니티 리소스

아래는 Hunyuan3D-2 관련 ComfyUI 커뮤니티 리소스입니다.

* [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
* [Kijai/Hunyuan3D-2\_safetensors](https://huggingface.co/Kijai/Hunyuan3D-2_safetensors/tree/main)
* [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack)

## Hunyuan3D 2.0 오픈소스 모델 시리즈

현재 Hunyuan3D 2.0은 완전한 3D 생성 과정을 포괄하는 여러 모델을 오픈소스로 공개했습니다. 자세한 정보는 [Hunyuan3D-2](https://github.com/Tencent/Hunyuan3D-2)를 방문해 확인하실 수 있습니다.

**Hunyuan3D-2mini 시리즈**

| 모델                    | 설명             | 날짜         | 파라미터 | Huggingface                                                                          |
| --------------------- | -------------- | ---------- | ---- | ------------------------------------------------------------------------------------ |
| Hunyuan3D-DiT-v2-mini | 미니 이미지 → 형상 모델 | 2025-03-18 | 0.6B | [방문](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) |

**Hunyuan3D-2mv 시리즈**

| 모델                       | 설명                                               | 날짜         | 파라미터 | Huggingface                                                                           |
| ------------------------ | ------------------------------------------------ | ---------- | ---- | ------------------------------------------------------------------------------------- |
| Hunyuan3D-DiT-v2-mv-Fast | 지침 증류 버전, DIT 추론 시간 절반으로 줄일 수 있음                 | 2025-03-18 | 1.1B | [방문](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) |
| Hunyuan3D-DiT-v2-mv      | 다중뷰 이미지 → 형상 모델, 장면을 이해하는 데 여러 각도가 필요한 3D 생성에 적합 | 2025-03-18 | 1.1B | [방문](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv)      |

**Hunyuan3D-2 시리즈**

| 모델                      | 설명          | 날짜         | 파라미터 | Huggingface                                                                        |
| ----------------------- | ----------- | ---------- | ---- | ---------------------------------------------------------------------------------- |
| Hunyuan3D-DiT-v2-0-Fast | 지침 증류 모델    | 2025-02-03 | 1.1B | [방문](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) |
| Hunyuan3D-DiT-v2-0      | 이미지 → 형상 모델 | 2025-01-21 | 1.1B | [방문](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0)      |
| Hunyuan3D-Paint-v2-0    | 텍스처 생성 모델   | 2025-01-21 | 1.3B | [방문](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0)    |
| Hunyuan3D-Delight-v2-0  | 이미지 딜라이트 모델 | 2025-01-21 | 1.3B | [방문](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0)  |