> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-463e218.mintlify.site/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 모델 생성 기능을 지원합니다:

* 텍스트 기반 3D 생성
* 이미지 기반 3D 생성
* 멀티뷰 기반 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 버전(최신 테스트 버전(nightly))을 사용하고 있지 않음
      2. 일부 노드가 시작 시 가져오기에 실패함
    </Tab>

    <Tab title="클라우드 사용자">
      * [클라우드](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 모델을 미리 보고 내보냅니다.

<h3 id="api_hunyuan3d_text_to_model">
  HunYuan3D: 텍스트를 모델로
</h3>

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

**예시 프롬프트**: "Mechanical dolphin with gears, steampunk"

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_text_to_model-1.webp" alt="HunYuan3D: 텍스트를 모델로 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_text_to_model&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan3d-3-0">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_text_to_model.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "HunYuan3D: Text to Model"을 검색하세요
  </Card>
</CardGroup>

<h3 id="api_hunyuan3d_image_to_model">
  HY 3D: 이미지를 모델로
</h3>

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_image_to_model-1.webp" alt="HY 3D: 이미지를 모델로 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_image_to_model&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan3d-3-0">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_image_to_model.json">
    JSON을 다운로드하거나 템플릿 라이브러리에서 "HY 3D: Image to Model"을 검색하세요
  </Card>
</CardGroup>

**입력 파일**

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

<CardGroup cols={2}>
  <Card title="pink_robot_front.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png">
    `LoadImage` 노드 1 · `pink_robot_front.png`
  </Card>

  <Card title="pink_robot_back.png" icon="image" href="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_back.png">
    `LoadImage` 노드 10 · `pink_robot_back.png`
  </Card>
</CardGroup>

<div style={{display: 'grid', gridTemplateColumns: 'repeat(2, minmax(0, 1fr))', gap: '1rem', alignItems: 'start'}}>
  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_front.png" alt="pink_robot_front.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />

  <img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/pink_robot_back.png" alt="pink_robot_back.png" style={{width: '100%', height: 'auto', objectFit: 'contain'}} />
</div>

## 고급 기능

최초 [HY 3D 3.0 통합](https://blog.comfy.org/p/hunyuan-3d-30-in-comfyui-state-of)에 이어, Hunyuan 3D의 고급 처리 기능을 이제 파트너 노드를 통해 사용할 수 있습니다. 이러한 워크플로는 핵심 후처리 단계를 ComfyUI로 가져와 생성과 프로덕션 사이의 간격을 좁히는 데 도움을 줍니다.

<h3 id="api_hunyuan3d_part">
  HY 3D: 3D 파츠 분해
</h3>

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_part-1.webp" alt="HY 3D: 3D 파츠 분해 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_part&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan3d-3-0">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_part.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "HY 3D: 3D 파츠 분해" 검색
  </Card>
</CardGroup>

<h3 id="api_hunyuan3d_model2uv">
  HY 3D: UV 언랩핑
</h3>

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_model2uv-1.webp" alt="HY 3D: UV 언랩핑 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_model2uv&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan3d-3-0">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_model2uv.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "HY 3D: UV 언랩핑" 검색
  </Card>
</CardGroup>

<h3 id="api_hunyuan3d_smart_topology">
  HY 3D: 스마트 토폴로지
</h3>

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

<img src="https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/api_hunyuan3d_smart_topology-1.webp" alt="HY 3D: 스마트 토폴로지 워크플로 미리보기" />

<CardGroup cols={2}>
  <Card title="Comfy Cloud에서 실행" icon="cloud" href="https://cloud.comfy.org/?template=api_hunyuan3d_smart_topology&utm_source=docs&utm_medium=referral&utm_campaign=hunyuan3d-3-0">
    Comfy Cloud에서 열기
  </Card>

  <Card title="워크플로 다운로드" icon="download" href="https://github.com/Comfy-Org/workflow_templates/blob/main/templates/api_hunyuan3d_smart_topology.json">
    JSON 다운로드 또는 템플릿 라이브러리에서 "HY 3D: 스마트 토폴로지" 검색
  </Card>
</CardGroup>