# Step1X-3D Geometry (로컬 3D 모델)

> 로컬 이미지→3D: StepFun의 Step1X-3D Geometry 1.3B가 이미지 한 장을 게임 소품과 캐릭터용 텍스처 없는 3D 메시(GLB)로 만들어 줍니다. VRAM 16 GB의 NVIDIA GPU에서 실행됩니다. Local Python models runtime에서 오프라인으로 동작합니다. Apache-2.0, 상업적 사용 허용.

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

## 설치

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

```bash
gamedev pkg add aigd.model3d-step1x-3d-geometry
```

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

## 버전

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

## 설명

````markdown
# Step1X-3D Geometry 1.3B (`aigd.model3d-step1x-3d-geometry`)

Step1X-3D Geometry 1.3B는 NVIDIA GPU(VRAM 16 GB 이상)에서 이미지 한 장을 3D 형상으로 바꿔 줍니다. StepFun의 [Step1X-3D](https://github.com/stepfun-ai/Step1X-3D) 지오메트리 모델을 사용합니다. 결과물은 텍스처가 없는 GLB입니다. AI Game Dev에서는 **Local Python models runtime**(`aigd.python`)을 통해 로컬에서 실행됩니다. 가중치와 코드는 Apache-2.0이며 지역 제한이나 사용자 수 제한이 없어 어디서든 상업용 게임에 적합합니다.

## 무엇을 만들 수 있나요

- 이미지 한 장으로 소품, 건물, 탈것, 생물, 캐릭터의 텍스처 없는 메시를 만듭니다.
- 나중에 텍스처를 입히거나 리토폴로지, 리깅할 기본 메시입니다.
- 컨셉 아트로 만드는 3D 블록아웃입니다.

## 요청 예시

- "`Concepts/barrel.png`를 Step1X-3D로 3D 모델로 만들어 주세요."
- "드래곤 컨셉의 메시를 만들어 주세요."
- "이 집 이미지의 3D 형상을 생성해 주세요."

## 주요 특징

|  |  |
|---|---|
| 모델 id | `aigd.model3d-step1x-3d-geometry.v1` |
| 동작 | 이미지 → 3D (투명 배경의 입력 이미지 한 장) |
| 출력 | 텍스처 없는 GLB, 기본적으로 면 수를 200,000개로 줄임 |
| 스텝 | 기본값 50 |
| 실행 환경 | VRAM 16 GB 이상의 NVIDIA GPU (CUDA) |
| 다운로드 | 약 7.2 GB, 최초 로드 시 런타임의 Python 환경이 추가됨 |
| 라이선스 | Apache-2.0, 상업적 사용 허용 |

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

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): 텍스처 없음, VRAM 8 GB.
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape): 텍스처 없음, VRAM 10 GB.
- [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.

## 실행 방식

**Step1X-3D 텍스처 모델은 포함되지 않습니다.** 이 모델은 `nvdiffrast`(NVIDIA Source Code License, 비상업적)과 `pytorch3d`(사전 빌드 패키지 없음)이 필요하므로 앱의 런타임에서는 실행할 수 없습니다. 투명 배경에 객체 하나가 있는 이미지를 사용하세요. 앱이 이미지를 객체 기준으로 잘라 냅니다. 면 수는 기본적으로 200,000개로 줄어듭니다.

출력물에는 작게 분리된 부분이 포함될 수 있습니다. 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.2 GB, Hugging Face 리비전과 sha256으로 고정:

| 파일 | 크기 | 라이선스 | 출처 |
|---|---|---|---|
| `model_index.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/model_index.json) |
| `scheduler-scheduler_config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/scheduler/scheduler_config.json) |
| `transformer-config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/config.json) |
| `transformer-diffusion_pytorch_model.safetensors` | 5.27 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/diffusion_pytorch_model.safetensors) |
| `vae-config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/config.json) |
| `vae-diffusion_pytorch_model.safetensors` | 0.77 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/diffusion_pytorch_model.safetensors) |
| `visual_eature_extractor-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_eature_extractor/preprocessor_config.json) |
| `visual_encoder-config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/config.json) |
| `visual_encoder-diffusion_pytorch_model.safetensors` | 1.22 GB | Apache-2.0 | [파일](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/diffusion_pytorch_model.safetensors) |
| `dinov2-with-registers-large-config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/config.json) |
| `dinov2-with-registers-large-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [파일](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/preprocessor_config.json) |

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

## 라이선스

- **가중치: Apache-2.0**, © StepFun ([모델 카드](https://huggingface.co/stepfun-ai/Step1X-3D/tree/bf7084495b3a72222f36549b7942948aa4d9daa7)).
- **추론 코드**(`step1x3d_geometry/`, GitHub의 커밋 [`cb5ac94`](https://github.com/stepfun-ai/Step1X-3D/tree/cb5ac944709c6c913109070c7b90c3447f57f3d4)): Apache-2.0 ([라이선스](https://github.com/stepfun-ai/Step1X-3D/blob/cb5ac944709c6c913109070c7b90c3447f57f3d4/LICENSE)).
- **DINOv2 with registers (large) 구성 파일**: Apache-2.0, © Meta Platforms ([모델 카드](https://huggingface.co/facebook/dinov2-with-registers-large/tree/e4c89a4e05589de9b3e188688a303d0f3c04d0f3)). 이 파일의 `config.json`과 `preprocessor_config.json`만 다운로드하며, 인코더 가중치는 Step1X-3D에 포함되어 있습니다.

필수 저작자 표시: "Step1X-3D © StepFun (Apache-2.0)".

**제한 사항:** 상업적 사용이 허용됩니다. 가중치를 재배포하려면 Apache-2.0 라이선스 전문과 StepFun의 고지를 포함해야 합니다.
````
