# Hunyuan3D-2.1 Shape (로컬 3D 모델)

> 로컬 이미지→3D: Tencent Hunyuan3D-2.1의 shape 모델이 이미지 한 장을 고품질의 텍스처 없는 3D 메시(GLB)로 만들어 게임 소품과 캐릭터에 활용할 수 있습니다. VRAM 10 GB 이상의 NVIDIA GPU에서 실행됩니다. Local Python models runtime에서 오프라인으로 동작합니다. EU, 영국, 한국에서는 라이선스되지 않습니다.

- Id: `aigd.model3d-hunyuan3d-2-1-shape`
- 소스: 공식 (자사 `aigd.*`)
- 카테고리: 3D
- 게시자: AI Game Dev (`aigd`), 인증됨
- 최신 버전: 1.0.3 (2026-11-22 게시)
- 라이선스: SEE LICENSE IN README.md
- AI Game Dev 앱 필요: `>=0.32.0-beta.6`
- 네이티브 코드: 아니요
- 평점: 아직 평가 없음
- HTML 페이지: https://ai-game.dev/ko/packages/aigd.model3d-hunyuan3d-2-1-shape

## 설치

gamedev CLI를 사용한다면 프로젝트 폴더에서:

```bash
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
```

데스크톱 앱에서 Packages 창을 열고(상태 표시줄의 패키지 아이콘) **Browse**를 선택한 뒤 `aigd.model3d-hunyuan3d-2-1-shape`를 검색하고 **Add to Project**를 클릭합니다. 자세히: https://ai-game.dev/docs/wiki/app/packages

## 버전

| 버전 | 게시일 | 앱 필요 | 참고 |
|---|---|---|---|
| 1.0.3 | 2026-11-22 | `>=0.32.0-beta.6` | 최신 |
| 1.0.2 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 설명

````markdown
# Hunyuan3D-2.1 Shape (`aigd.model3d-hunyuan3d-2-1-shape`)

Hunyuan3D-2.1 Shape은 이미지 한 장을 고품질 3D 형상으로 변환하며, Tencent의 [Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) shape 모델을 사용해 NVIDIA GPU(VRAM 10 GB 이상)에서 실행됩니다. 결과물은 텍스처 없는 GLB 메시입니다. AI Game Dev에서는 **Local Python models runtime**(`aigd.python`)을 통해 로컬로 실행됩니다. 소품과 캐릭터용으로 정교한 기본 메시를 원하고 텍스처링은 다른 곳에서 하려는 개발자에게 적합합니다. **유럽연합, 영국, 한국에서는 라이선스되지 않습니다.**

## 무엇을 만들 수 있나요

- 컨셉 이미지 한 장으로 소품, 무기, 가구, 생물, 캐릭터의 텍스처 없는 3D 메시를 만듭니다.
- 나중에 직접 쓰는 도구나 다른 패키지로 텍스처링, 리토폴로지, 리깅할 기본 메시입니다.
- 컨셉 아트로 빠르게 만드는 3D 블록아웃입니다.

## 요청 예시

- "`Concepts/treasure_chest.png`을 Hunyuan3D로 3D 모델로 만들어 주세요."
- "이 검 이미지(투명 배경)로 3D 형상을 만들어 주세요."
- "방금 추가한 캐릭터 컨셉의 메시를 생성해 주세요."

## 주요 특징

|  |  |
|---|---|
| 모델 ID | `aigd.model3d-hunyuan3d-2-1-shape.v1` |
| 동작 | 이미지→3D (입력 이미지 1장) |
| 출력 | 텍스처 없는 GLB |
| 스텝 | 기본값 50 |
| 실행 환경 | VRAM 10 GB 이상의 NVIDIA GPU (CUDA) |
| 다운로드 | 약 7.4 GB, 첫 로드 시 런타임의 Python 환경 별도 |
| 라이선스 | Tencent Hunyuan 3D 2.1 Community License: EU, 영국, 한국에서는 사용 불가; 월간 활성 사용자 100만 명 초과 시 별도 라이선스 |

## 다른 로컬 이미지→3D 모델

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): 텍스처 없음, VRAM 8 GB.
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry): 텍스처 없음, VRAM 16 GB, Apache-2.0.
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b)와 [Pixal3D](https://ai-game.dev/packages/aigd.model3d-pixal3d): PBR 재질의 텍스처 포함 GLB, NVIDIA 또는 Vulkan GPU에서 16 GB.

## 실행 방식

**Hunyuan3D-2.1의 PBR 텍스처 모델은 포함되어 있지 않습니다.** 이 모델은 사용자의 컴퓨터에서 컴파일해야 하는 사용자 정의 CUDA 래스터라이저와 Python 모듈로서의 Blender를 필요로 하며, 앱의 런타임은 이를 수행하지 않습니다. 배경이 투명한, 객체 하나짜리 이미지를 사용하세요. 체크포인트는 PyTorch 파일로, 텐서로만 로드되며(`weights_only=True`) 코드로는 실행되지 않습니다.

출력에 작게 분리된 부분이 포함될 수 있습니다. TripoSG, Step1X-3D, Hunyuan3D의 GPU 검사에서 주 구성 요소가 전체 면의 97.5–99.2%를 차지했습니다.

이 패키지는 데이터만 포함합니다. **Local Python models runtime**(`aigd.python`)이 필요하며, 이 런타임은 모델을 처음 로드할 때 해당 모델을 위한 전용 Python 환경을 구성합니다(PyTorch와 라이브러리 몇 GB, 해당 패키지의 README 참고). 모델은 오프라인으로 실행되며, 가중치는 아래 나열된 파일에서만 제공되고 사용자가 확인한 뒤 Hugging Face에서 다운로드됩니다. AI Game Dev는 이를 호스팅하지 않습니다.

## 다운로드되는 항목

약 7.4 GB, Hugging Face 리비전과 sha256으로 고정:

| 파일 | 크기 | 라이선스 | 출처 |
|---|---|---|---|
| `hunyuan3d-dit-v2-1-config.yaml` | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | [파일](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/config.yaml) |
| `hunyuan3d-dit-v2-1-model.fp16.ckpt` | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | [파일](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/model.fp16.ckpt) |

모델의 Python 코드는 고정된 커밋의 GitHub에서 다운로드되며, 각 파일은 sha256으로 검증됩니다.

## 라이선스

- **가중치와 추론 코드: Tencent Hunyuan 3D 2.1 Community License** ([라이선스](https://huggingface.co/tencent/Hunyuan3D-2.1/blob/0b94677654c57bb9a6b6845cd7b704ccf551d327/LICENSE), [모델 카드](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/0b94677654c57bb9a6b6845cd7b704ccf551d327); 코드 `hy3dshape/`, GitHub 커밋 [`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)).

`hy3dshape` 파일 헤더에는 "비상업적" 라이선스가 언급되어 있지만, 저장소의 `LICENSE`(위)가 Community License이며, 이것이 적용됩니다.

필수 저작자 표시(Notice): "Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."

**제한 사항:**
- **유럽연합, 영국, 한국에서는 라이선스되지 않습니다.** 해당 지역에서는 모델이나 그 출력물을 사용할 수 없습니다.
- **월간 활성 사용자 100만 명을 초과하는** 제품이나 서비스는 Tencent로부터 별도의 라이선스를 받아야 합니다.
- 모델과 그 출력물은 다른 AI 모델을 개선하는 데 사용할 수 없습니다.
- Tencent의 허용 가능한 사용 정책(Acceptable Use Policy)이 적용됩니다.

사용이 허용되는지 확인할 책임은 사용자에게 있습니다.
````
