Hunyuan 3D 파트너 노드 모델 생성 ComfyUI 공식 예제

이 글에서는 ComfyUI에서 Hunyuan 3D 노드의 API를 사용해 3D 모델을 생성하는 방법을 소개합니다.

Hunyuan 3D 3.0은 텐센트가 개발한 최첨단 3D 생성 모델로, 몇 분 내에 3D 콘텐츠를 제작할 수 있게 해줍니다. 기존의 3D 모델링 파이프라인보다 훨씬 낮은 진입 장벽으로 텍스트 프롬프트, 이미지 또는 스케치로부터 생산 준비가 완료된 3D 자산을 생성할 수 있습니다.

ComfyUI는 현재 해당 Hunyuan 3D API를 기본적으로 통합하여, ComfyUI에서 관련 노드를 편리하게 사용해 모델을 생성할 수 있도록 지원합니다.

현재 ComfyUI의 파트너 노드는 다음과 같은 Hunyuan 3D 모델 생성 기능을 지원합니다:

• 텍스트 기반 3D 생성
• 이미지 기반 3D 생성
• 멀티뷰 기반 3D 모델 생성

파트너 노드를 사용하려면 올바르게 로그인되어 있고 허가된 네트워크 환경을 사용하고 있는지 확인해야 합니다. 파트너 노드를 사용하기 위한 구체적인 요구사항은 문서의 파트너 노드 개요 섹션을 참조해 주세요.

로컬 사용자

ComfyUI가 최신 버전으로 업데이트되었는지 확인하세요.

• ComfyUI 다운로드
• 업데이트 가이드

이 가이드의 워크플로는 워크플로 템플릿에서 확인할 수 있습니다. 템플릿에서 찾을 수 없다면, 귀하의 ComfyUI가 오래된 버전일 수 있습니다.

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

1. 최신 ComfyUI 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
2. 일부 노드가 시작 시 가져오기에 실패함

클라우드 사용자

• 클라우드는 ComfyUI 안정판 출시 후 업데이트됩니다.

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

​

활용 사례

• 게임 개발 아이디어: 리깅과 실시간 렌더링에 최적화된 토폴로지를 갖춘 캐릭터, 소품 및 환경을 빠르게 생성
• 제품 및 전자상거래: 제품 사진을 인터랙티브한 3D 모델로 변환해 온라인에 전시
• 산업 디자인: 스케치를 3D 프로토타입으로 변환하고 3D 프린팅 준비가 가능한 부품 분해
• VFX 및 애니메이션: 전문적인 UV와 PBR 재질을 갖춘 고해상도 에셋

​

시작하기

​

1. 워크플로 템플릿 접근

1. 사이드바에서 템플릿 라이브러리를 엽니다.
2. 3D → Hunyuan 3D로 이동합니다.
3. Hunyuan 3D용 워크플로 템플릿을 선택합니다.

​

2. 워크플로 실행

1. 워크플로 유형에 따라 텍스트 프롬프트, 이미지 또는 스케치를 입력합니다.
2. 실행 버튼을 클릭하거나 단축키 Ctrl(cmd) + Enter를 사용하여 모델 생성을 실행합니다.
3. 워크플로가 완료된 후 3D 모델을 미리 보고 내보냅니다.

​

HunYuan3D: 텍스트를 모델로

텍스트 프롬프트를 입력하거나 참조 이미지를 업로드하여 상세한 3D 모델 에셋을 생성하세요.

예시 프롬프트: “Mechanical dolphin with gears, steampunk”

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON을 다운로드하거나 템플릿 라이브러리에서 “HunYuan3D: Text to Model”을 검색하세요

​

HY 3D: 이미지를 모델로

이미지를 업로드하여 지오메트리와 PBR 텍스처를 갖춘 3D 모델을 생성하세요. 지오메트리와 재질 충실도를 높이려면 서로 다른 각도에서 촬영한 멀티뷰 이미지 2~4장을 업로드하세요.

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON을 다운로드하거나 템플릿 라이브러리에서 “HY 3D: Image to Model”을 검색하세요

입력 파일

다음 파일을 해당 LoadImage 노드에 업로드하세요:

pink_robot_front.png

LoadImage 노드 1 · pink_robot_front.png

pink_robot_back.png

LoadImage 노드 10 · pink_robot_back.png

​

고급 기능

최초 HY 3D 3.0 통합에 이어, Hunyuan 3D의 고급 처리 기능을 이제 파트너 노드를 통해 사용할 수 있습니다. 이러한 워크플로는 핵심 후처리 단계를 ComfyUI로 가져와 생성과 프로덕션 사이의 간격을 좁히는 데 도움을 줍니다.

​

HY 3D: 3D 파츠 분해

3D 모델을 업로드하면 자동으로 구성 요소로 분할되어, 재사용 및 편집이 가능한 완전히 분해된 3D 에셋이 생성됩니다.

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “HY 3D: 3D 파츠 분해” 검색

​

HY 3D: UV 언랩핑

3D 모델을 업로드하여 UV 언랩핑을 수행합니다. 텍스처링에 최적화된 UV 레이아웃을 가진 처리된 모델을 생성합니다.

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “HY 3D: UV 언랩핑” 검색

​

HY 3D: 스마트 토폴로지

하이폴리 3D 모델 파일을 업로드하세요. 지정된 축소 수준으로 폴리곤 수가 낮고 토폴로지가 최적화된 3D 모델을 생성합니다.

Comfy Cloud에서 실행

Comfy Cloud에서 열기

워크플로 다운로드

JSON 다운로드 또는 템플릿 라이브러리에서 “HY 3D: 스마트 토폴로지” 검색