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

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

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

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

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

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

* 텍스트-to-3D 생성
* 이미지-to-3D 생성
* 멀티뷰-to-3D 생성

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

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

## 활용 사례

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

## 시작하기

### 1. 워크플로우 템플릿 접속

1. 사이드바에서 템플릿 라이브러리를 열기
2. **3D** → **Hunyuan 3D**로 이동
3. Hunyuan 3D용 워크플로우 템플릿 선택

### 2. 워크플로우 실행

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

## 텍스트-to-3D 워크플로우

텍스트 설명을 입력하면 한 번의 클릭으로 3D 모델을 생성합니다. 모델은 스타일, 형태, 재질 디테일을 정확히 따르며 일관된 결과를 제공합니다.

**예제 프롬프트**: "톱니바퀴가 달린 기계적 돌고래, 스팀펑크"

<Card title="Hunyuan 3D 텍스트-to-3D 워크플로우" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_text_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  Comfy Cloud에서 실행
</Card>

## 이미지-to-3D 워크플로우

하나 이상의 이미지를 업로드해 고품질 3D 모델을 생성합니다. 2\~4개의 멀티뷰 이미지 지원으로 지오메트리와 재질의 정밀도가 향상됩니다.

<Card title="Hunyuan 3D 이미지-to-3D 워크플로우" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_image_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  Comfy Cloud에서 실행
</Card>

## 멀티뷰-to-3D 워크플로우

앞면, 뒷면, 옆면 등 여러 각도의 이미지를 제공해 더욱 정확하고 세부적인 3D 모델을 생성합니다. 이는 이미지-to-3D와 동일한 워크플로우로, 서로 다른 각도의 이미지 2\~4장을 업로드하기만 하면 됩니다.

<Card title="Hunyuan 3D 이미지-to-3D 워크플로우" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_image_to_model&utm_source=docs&utm_medium=inhouse_social&utm_campaign=inhouse_feature_launches&utm_content=post&utm_niche=workflow_engineering&utm_creator=purz">
  Comfy Cloud에서 실행
</Card>

## 고급 기능

[초기 HY 3D 3.0 통합](https://blog.comfy.org/p/hunyuan-3d-30-in-comfyui-state-of) 이후, Hunyuan 3D의 고급 처리 기능들이 파트너 노드를 통해 이용 가능해졌습니다. 이러한 워크플로우는 주요 후처리 단계를 ComfyUI로 가져옴으로써 생성과 생산 간의 격차를 줄여줍니다.

### 3D 부품 분해

완전한 3D 모델을 갑옷 조각, 액세서리, 바퀴 등 의미 있는 구조적 부품으로 나눕니다. 이를 통해 자산의 특정 영역을 쉽게 편집하고, 부품을 교체해 다양한 변형을 만들며, 모듈식 워크플로우, 애니메이션 또는 하위 조립을 위한 모델을 준비할 수 있습니다.

<Card title="Comfy Cloud에서 시도하기" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_part&utm_source=docs">
  워크플로우 실행
</Card>

<Card title="워크플로우 다운로드" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_part.json">
  JSON 파일 받기
</Card>

### UV 언랩핑

지원되는 3D 모델에 대해 자동으로 UV 레이아웃을 생성해 원시 지오메트리를 훨씬 더 쉽게 텍스처링할 수 있는 자산으로 변환합니다. 수작업으로 이음새를 자르고 UV 섬을 정리하는 대신, 창작자는 보다 깔끔한 시작점에서 페인팅, 베이킹 및 재질 작업으로 빠르게 진행할 수 있습니다.

<Card title="Comfy Cloud에서 시도하기" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_model2uv&utm_source=docs">
  워크플로우 실행
</Card>

<Card title="워크플로우 다운로드" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_model2uv.json">
  JSON 파일 받기
</Card>

### 스마트 토폴로지

밀도 높은 지오메트리를 보다 깔끔한 메쉬로 변환해 에지 흐름을 정리하며, 생성된 모델을 실제 생산 파이프라인에서 더 쉽게 최적화하고 재사용할 수 있도록 돕습니다. 특히 게임 엔진, 실시간 렌더링 또는 밀도가 낮고 구조가 더 좋은 지오메트리를 활용하는 모든 워크플로우에 유용합니다.

<Card title="Comfy Cloud에서 시도하기" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_smart_topology&utm_source=docs">
  워크플로우 실행
</Card>

<Card title="워크플로우 다운로드" icon="github" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_smart_topology.json">
  JSON 파일 받기
</Card>