Hunyuan3D 2.0 완전 가이드: ComfyUI 네이티브 지원 및 ComfyUI-Hunyuan3DWrapper 포함
Hunyuan3D-2는 텐센트가 출시한 오픈소스 3D 생성 모델 시리즈입니다. 2025년 3월 기준 최신 버전은 2.0으로, 텍스트, 이미지 또는 스케치를 통해 고해상도 텍스처 맵이 포함된 고품질 3D 모델 생성을 지원합니다.
기술적 하이라이트
이 시스템은 기하학 생성 + 텍스처 합성의 분리된 프로세스를 채택했습니다:
- 기하학 생성(Hunyuan3D-DiT): 텍스처가 없는 3D 기하학 모델을 생성하는 플로우 확산 모델 기반으로, 2.6B 매개변수를 가지며 입력 이미지나 텍스트에서 기하학적 정보를 정확히 추출할 수 있습니다.
- 텍스처 합성(Hunyuan3D-Paint): 기하학 모델에 고해상도(4K) 텍스처를 추가하며, 1.3B 매개변수를 가지고, 사실적인 텍스처와 일관된 조명을 보장하기 위한 다중 뷰 확산 생성 기술을 지원합니다.
형태와 텍스처 생성을 분리함으로써 복잡성을 효과적으로 줄이고 생성 품질을 향상시킵니다.
성능 및 효율성 최적화
- 빠른 생성: 모델 생성을 최대 30초 만에 완료하며, 가속 버전(Hunyuan3D-DiT-v2-0-Fast)은 가이던스 증류 기술을 통해 추론 시간을 50% 단축합니다.
- 다중 모달 입력: 텍스트 설명, 이미지, 스케치 등 다양한 입력 방법을 지원하며, Blender 플러그인 및 Gradio 애플리케이션과 호환되어 사용 장벽을 낮춥니다.
오픈소스 모델 생태계 이 프로젝트는 6개의 모델(일부는 간소화 버전)을 오픈소스화했으며, 다양한 시나리오 요구를 충족합니다:
- Hunyuan3D-2mv: 다중 뷰 형태 생성 모델로, 복잡한 장면 모델링에 적합합니다.
- Hunyuan3D-Delight-v2-0: 이미지 조명 제거 모델로, 조명에 영향을 받지 않는 텍스처를 생성합니다. 기타 모델에는 경량 버전(2mini), 고품질 기하학 생성(DiT-v2-0) 등이 포함됩니다.
다음은 ComfyUI에 의존하지 않고 Hunyuan3D 2.0을 경험할 수 있는 온라인 플랫폼이나 구현입니다:
이제 ComfyUI에서 Hunyuan3D 2.0 모델 생성을 구현하는 접근 방식을 소개하겠습니다.
ComfyUI에서 Hunyuan3D 2.0 모델 생성 구현 접근 방식
다음은 이 가이드에서 다룰 주요 접근 방식입니다. 각각에 대해 완전한 워크플로우와 단계별 튜토리얼을 제공합니다.
ComfyUI-Hunyuan3DWrapper
Kijai가 개발한 이 플러그인은 현재 ComfyUI에서 가장 완전한 지원과 성능을 제공하며, 모델에서 텍스처까지 완전한 렌더링 출력을 구현할 수 있습니다. 그러나 텍스처 생성 부분은 별도 구성 요소의 컴파일이 필요하며, Python 가상 환경과 pip
명령에 대한 기본 지식이 필요합니다.
ComfyUI 네이티브 지원
ComfyUI는 현재 Hunyuan3D 2.0 및 2mv 시리즈 모델을 공식적으로 지원하여 모델 렌더링이 가능합니다. 그러나 아직 텍스처 렌더링은 지원하지 않으며, 자체적인 미적 매력을 가진 복셀 모델을 출력합니다. ComfyUI의 최신 버전으로 업데이트하기만 하면 사용할 수 있어 사용과 경험이 간단합니다.
ComfyUI 3D Pack
이 플러그인의 주요 문제는 의존성 환경이 최신 ComfyUI 의존성 환경과 다르기 때문에 설치가 매우 어렵다는 것입니다. 여러 번 시도했지만 성공하지 못했기 때문에 이 기사에서는 관련 부분과 관련 리소스에 대한 소개만 제공할 수 있습니다.
입력 이미지
이 예제에서는 여러 워크플로우가 관련되어 있어 해당 입력 이미지를 제공합니다. 이 자료들은 모두 ComfyUI 공식 문서에서 사용된 샘플 이미지에서 가져온 것이지만, 자신의 이미지를 사용할 수도 있습니다.
ComfyUI-Hunyuan3DWrapper 플러그인은 ComfyUI-essentials 플러그인 노드를 사용하여 자동 배경 제거를 완료하지만, ComfyUI 네이티브 지원 워크플로우는 이 기능을 제공하지 않기 때문에 여기에서 제공되는 이미지는 이미 처리되었습니다. 자신의 이미지를 사용하려면 ComfyUI-Hunyuan3DWrapper 플러그인의 배경 제거 부분을 참조하세요.






ComfyUI-Hunyuan3DWrapper Hunyuan3D 2.0 워크플로우
이 섹션에서는 ComfyUI-Hunyuan3DWrapper 플러그인을 사용하여 Hunyuan3D 2.0 모델 생성을 구현합니다. 해당 워크플로우를 재구성하고 워크플로우 파일에 모델 다운로드 링크를 추가했습니다.
1. 관련 플러그인 설치
Kijai의 워크플로우는 다음 두 가지 플러그인에 의존합니다:
ComfyUI Manager를 통해 이러한 플러그인을 설치할 수 있습니다.
1.1 기본 플러그인 의존성 설치
이 부분은 ComfyUI 플러그인 설치에 익숙한 독자들에게 친숙할 것입니다. ComfyUI Manager를 통해 플러그인을 설치한 경우 의존성이 자동으로 설치되어야 합니다.
수동으로 또는 git을 통해 설치한 경우, 해당 ComfyUI 가상 환경에서 의존성 설치 명령을 실행해야 합니다.
ComfyUI 플러그인 설치 가이드의 끝에 있는 의존성 설치 섹션을 참조하여 이를 완료하세요.
1.2 텍스처 생성 구성 요소 설치
ComfyUI-Hunyuan3DWrapper의 기본 의존성을 설치한 후, 텍스처 생성에 필요한 구성 요소를 컴파일하고 설치해야 합니다. 작성자는 특정 환경을 위한 사전 컴파일된 휠 파일을 제공했습니다.
작성자는 해당 디렉토리에 이러한 파일을 제공하고 플러그인의 Readme에서 사용 방법을 설명했습니다. ComfyUI Wiki 독자가 다국어 사용자임을 고려하여 이 내용 부분을 번역하고 정리했습니다.
1.2.1 사전 컴파일된 휠 파일 설치
사전 컴파일된 휠 파일을 설치하는 것은 간단합니다. 다음 단계를 따르세요:
- ComfyUI-Hunyuan3DWrapper 디렉토리로 이동합니다
- 시스템에 맞는 휠 파일을 선택합니다. 예를 들어, Windows 사용자는
wheels/win/gridencoder-0.1.0-cp310-cp310-win_amd64.whl
파일을 사용할 수 있습니다 - 가상 환경에서 pip를 사용하여 휠 파일을 설치합니다. 예:
pip install wheels/win/gridencoder-0.1.0-cp310-cp310-win_amd64.whl
사전 컴파일된 휠은 다음 환경용으로 제공됩니다:
- Windows CP310 CUDA 11.8
- Linux CP310 CUDA 11.8/12.1
1.2.2 수동 컴파일
사전 컴파일된 휠이 시스템과 호환되지 않는 경우, 수동으로 컴파일하는 옵션이 있습니다. 예를 들어, MacOS 또는 다른 CUDA 버전 사용자의 경우:
hunyuan3d_code/dependencies
디렉토리로 이동합니다pip install ninja
명령을 실행합니다python setup.py bdist_wheel
명령을 실행합니다- 생성된 휠 파일은
dist
디렉토리에 위치합니다 pip install dist/gridencoder-0.1.0-*.whl
명령을 사용하여 휠 파일을 설치합니다
2. Hunyuan3D 2.0 다중 뷰 워크플로우
Hunyuan3D 2.0 모델을 사용하여 다중 뷰(여러 각도)에서 캐릭터를 생성하려면, 다음 워크플로우 파일을 다운로드하여 ComfyUI로 드래그합니다. 이는 관련 모델 다운로드를 자동으로 완료하도록 프롬프트할 것입니다.
2.1 필요한 모델
워크플로우는 다중 뷰 모델링을 위해 hunyuan3d-dit-v2-mv
시리즈 모델을 사용합니다. 수동으로 설치하려면:
- Tencent: hunyuan3d-dit-v2-mv/model.fp16.safetensors 다운로드 후
hunyuan3d-dit-v2-mv-fp16.safetensors
로 이름 변경
2.2 입력 이미지 요구 사항
다중 뷰 워크플로우를 위해서는 최소 2개(최대 8개)의 서로 다른 각도에서 찍은 이미지가 필요합니다. 모델은 앞, 뒤, 왼쪽, 오른쪽, 위, 아래 및 왼쪽+오른쪽 45도(대각선) 뷰를 지원합니다.
- 이미지는 배경이 없이 투명해야 합니다
- 각 각도의 이미지 크기는 동일해야 합니다(예: 모두 512x512)
- 각도 이미지의 피사체는 방향을 제외하고 일관되어야 합니다
2.3 단계별 워크플로우 실행
Hy3DModelLoader
노드에서hunyuan3d-dit-v2-mv-fp16.safetensors
가 로드되었는지 확인합니다- 다른 각도의 입력 이미지를
Load Image
노드에 업로드합니다. 특정 각도의 이미지가 없는 경우, 해당 노드를 우클릭하고 모드를Never
로 설정합니다 Run
버튼을 클릭하거나 단축키Ctrl(cmd) + Enter
를 사용하여 워크플로우를 실행합니다
ComfyUI 네이티브 Hunyuan3D 2.0 워크플로우
ComfyUI는 현재 Hunyuan3D-2mv 시리즈 모델을 네이티브로 지원하며, 3D 기하학 모델을 직접 생성할 수 있습니다(현재 텍스처 재질 없음). ComfyUI를 최신 버전으로 업그레이드하기만 하면 이를 경험할 수 있습니다. ComfyUI Wiki는 Comfy 공식 문서를 유지하기 위해 Comfy 공식과 협력을 시작했으며, 이 내용 부분은 Comfy 공식 문서에 자세히 설명되어 있습니다. 그러나 공식 문서는 현재 중국어와 영어만 지원합니다. ComfyUI Wiki 독자의 편의를 위해, ComfyUI Wiki는 docs.comfy.org에 원래 게시된 내용을 우리 사이트에서 재구성하고 편집했습니다.
ComfyUI는 현재 세 가지 네이티브 워크플로우를 제공하며, 주로 Hunyuan3D 2.0 및 Hunyuan3D-2mv 시리즈 모델을 지원합니다:
- Hunyuan3D-2mv 다중 뷰 워크플로우
- Hunyuan3D-2mv-turbo 가속 다중 뷰 워크플로우
- Hunyuan3D-2 단일 뷰 워크플로우
이러한 워크플로우는 최신 버전의 ComfyUI 워크플로우 템플릿에 추가되었습니다. 메뉴 바 workflow -> workflow templates -> 3d에서 찾을 수 있습니다.
이 섹션을 시작하기 전에 ComfyUI를 최신 버전으로 업그레이드했는지 확인하세요. ComfyUI 업데이트 가이드를 참조하여 ComfyUI를 업데이트할 수 있습니다.
- ComfyUI-Hunyuan3DWrapper와 비교하여, 네이티브 워크플로우는 해당 모델을
ComfyUI/models/checkpoints/
디렉토리에 저장합니다. 모델은 동일하므로, 이전에 ComfyUI-Hunyuan3DWrapper 플러그인 워크플로우를 사용했다면 모델 저장 디렉토리를 적절히 조정해야 합니다. .glb
파일의 출력 위치는SaveGLB
노드에서 설정된 대로ComfyUI/output/mesh
디렉토리에 있습니다.
1. Hunyuan3D-2mv 다중 뷰 워크플로우 사용
1.1 워크플로우 예제
아래 이미지를 다운로드하여 ComfyUI로 드래그하면, 관련 모델 다운로드를 자동으로 완료하도록 프롬프트됩니다.

1.2 수동 모델 설치
hunyuan3d-dit-v2-mv.safetensors를 다운로드하고, hunyuan3d-dit-v2-mv.safetensors
로 이름을 변경한 후, ComfyUI/models/checkpoints/
디렉토리에 저장합니다.
1.3 단계별 워크플로우 실행
Image Only Checkpoint Loader(img2vid model)
노드에서 hunyuan3d-dit-v2-mv.safetensors 모델이 로드되었는지 확인합니다- 각
Load Image
노드에서 해당 각도의 이미지를 로드합니다 - 워크플로우를 실행하여 3D 모델을 생성합니다
2. Hunyuan3D-2mv-turbo 가속 워크플로우 사용
Hunyuan3D-2mv-turbo는 Hunyuan3D-2mv의 증류 버전으로, 더 빠른 실행을 제공합니다.
2.1 워크플로우 예제
아래 이미지를 다운로드하여 ComfyUI로 드래그하면, 관련 모델 다운로드를 자동으로 완료하도록 프롬프트됩니다.

2.2 수동 모델 설치
hunyuan3d-dit-v2-mv-turbo.safetensors를 다운로드하고, hunyuan3d-dit-v2-mv-turbo.safetensors
로 이름을 변경한 후, ComfyUI/models/checkpoints/
디렉토리에 저장합니다.
2.3 단계별 워크플로우 실행
Image Only Checkpoint Loader(img2vid model)
노드에서 hunyuan3d-dit-v2-mv-turbo.safetensors 모델이 로드되었는지 확인합니다- 각
Load Image
노드에서 해당 각도의 이미지를 로드합니다 - 이 워크플로우에서는 cfg가 1.0으로 설정되어 있으며, 증류 cfg 생성을 제어하기 위한
flux guidance
노드가 추가되었음에 주목하세요 - 워크플로우를 실행하여 3D 모델을 생성합니다
3. Hunyuan3D-2 단일 뷰 워크플로우 사용
Hunyuan3D-2 모델은 단일 뷰 입력에서 3D 모델 생성을 지원합니다.
3.1 워크플로우 예제
아래 이미지를 다운로드하여 ComfyUI로 드래그하면, 관련 모델 다운로드를 자동으로 완료하도록 프롬프트됩니다.

3.2 입력 이미지 예제
3.3 수동 모델 설치
hunyuan3d-dit-v2.safetensors를 다운로드하고, hunyuan3d-dit-v2.safetensors
로 이름을 변경한 후, ComfyUI/models/checkpoints/
디렉토리에 저장합니다.
3.4 단계별 워크플로우 실행
Image Only Checkpoint Loader(img2vid model)
노드에서hunyuan3d-dit-v2.safetensors
모델이 로드되었는지 확인합니다Load Image
노드에서 입력 이미지를 로드합니다- 이 워크플로우에서는
Hunyuan3Dv2ConditioningMultiView
가 아닌Hunyuan3Dv2Conditioning
노드를 사용함에 주목하세요 - 워크플로우를 실행하여 3D 모델을 생성합니다
ComfyUI 3D Pack
ComfyUI 3D Pack 설치 시 주요 문제는 의존성 충돌입니다. 플러그인의 환경 요구 사항은 최신 ComfyUI 버전의 요구 사항과 다르며, 특히 PyTorch 및 CUDA 버전 지원과 관련하여 차이가 있습니다. 시도해 보고 싶다면, ComfyUI-3D-Pack 프로젝트의 설치 지침을 참조할 수 있습니다. 또한, 커뮤니티 사용자들이 통합 패키지를 제공했으며, Comfy3D-WinPortable | 통합 패키지를 시도해 볼 수 있습니다.
추가 콘텐츠
텍스트에서 모델을 생성하는 방법
위의 워크플로우에서는 입력 이미지를 사용했습니다. 이러한 워크플로우 전에 텍스트-이미지 워크플로우를 추가하여 해당 이미지 콘텐츠를 생성할 수 있습니다. 다중 뷰 입력이 필요한 경우, ComfyUI-MVAdapter 플러그인을 사용하여 해당 캐릭터의 다양한 각도 이미지를 생성해 볼 수 있습니다.
Hunyuan3D 2.0 오픈소스 모델 시리즈
Hunyuan3D 2.0은 완전한 3D 생성 프로세스를 포함하는 여러 모델을 오픈소스화했습니다. 자세한 내용은 Hunyuan3D-2를 방문하여 알아볼 수 있습니다.
Hunyuan3D-2mini 시리즈
모델 | 설명 | 날짜 | 매개변수 | Huggingface |
---|---|---|---|---|
Hunyuan3D-DiT-v2-mini | 미니 이미지-형태 모델 | 2025-03-18 | 0.6B | 링크 |
Hunyuan3D-2mv 시리즈
모델 | 설명 | 날짜 | 매개변수 | Huggingface |
---|---|---|---|---|
Hunyuan3D-DiT-v2-mv-Fast | DIT 추론 시간을 절반으로 줄일 수 있는 가이던스 증류 버전 | 2025-03-18 | 1.1B | 링크 |
Hunyuan3D-DiT-v2-mv | 다중 각도가 필요한 3D 생성에 이상적인 다중 뷰 이미지-형태 모델 | 2025-03-18 | 1.1B | 링크 |
Hunyuan3D-2 시리즈
모델 | 설명 | 날짜 | 매개변수 | Huggingface |
---|---|---|---|---|
Hunyuan3D-DiT-v2-0-Fast | 가이던스 증류 모델 | 2025-02-03 | 1.1B | 링크 |
Hunyuan3D-DiT-v2-0 | 이미지-형태 모델 | 2025-01-21 | 1.1B | 링크 |
Hunyuan3D-Paint-v2-0 | 텍스처 생성 모델 | 2025-01-21 | 1.3B | 링크 |
Hunyuan3D-Delight-v2-0 | 이미지 조명 제거 모델 | 2025-01-21 | 1.3B | 링크 |
Hunyuan 3D 2.0 관련 링크
- Hunyuan3D 홈페이지: https://3d.hunyuan.tencent.com
- Hunyuan3D-2 데모: https://huggingface.co/spaces/tencent/Hunyuan3D-2
- Hunyuan3D-2 모델: https://huggingface.co/Tencent/Hunyuan3D-2
- Hunyuan3D-2mv 모델: https://huggingface.co/tencent/Hunyuan3D-2mv
- Hunyuan3D-2mv 데모: https://huggingface.co/spaces/tencent/Hunyuan3D-2mv
- GitHub: https://github.com/Tencent/Hunyuan3D-2
- Discord: https://discord.gg/GuaWYwzKbX
- 보고서: https://github.com/Tencent/Hunyuan3D-2/blob/main/assets/report/Tencent_Hunyuan3D_2_0.pdf
- 공식 웹사이트: http://3d-models.hunyuan.tencent.com