Step1X-3D Geometry (로컬 3D 모델)
gamedev pkg add aigd.model3d-step1x-3d-geometry개요
로컬 이미지→3D: StepFun의 Step1X-3D Geometry 1.3B가 이미지 한 장을 게임 소품과 캐릭터용 텍스처 없는 3D 메시(GLB)로 만들어 줍니다. VRAM 16 GB의 NVIDIA GPU에서 실행됩니다. Local Python models runtime에서 오프라인으로 동작합니다. Apache-2.0, 상업적 사용 허용.
Step1X-3D Geometry 1.3B는 NVIDIA GPU(VRAM 16 GB 이상)에서 이미지 한 장을 3D 형상으로 바꿔 줍니다. StepFun의 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: 텍스처 없음, VRAM 8 GB.
- Hunyuan3D-2.1 Shape: 텍스처 없음, VRAM 10 GB.
- TRELLIS.2 4B 및 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 | 파일 |
scheduler-scheduler_config.json | 0.00 GB | Apache-2.0 | 파일 |
transformer-config.json | 0.00 GB | Apache-2.0 | 파일 |
transformer-diffusion_pytorch_model.safetensors | 5.27 GB | Apache-2.0 | 파일 |
vae-config.json | 0.00 GB | Apache-2.0 | 파일 |
vae-diffusion_pytorch_model.safetensors | 0.77 GB | Apache-2.0 | 파일 |
visual_eature_extractor-preprocessor_config.json | 0.00 GB | Apache-2.0 | 파일 |
visual_encoder-config.json | 0.00 GB | Apache-2.0 | 파일 |
visual_encoder-diffusion_pytorch_model.safetensors | 1.22 GB | Apache-2.0 | 파일 |
dinov2-with-registers-large-config.json | 0.00 GB | Apache-2.0 | 파일 |
dinov2-with-registers-large-preprocessor_config.json | 0.00 GB | Apache-2.0 | 파일 |
모델의 Python 코드는 고정된 커밋의 GitHub에서 다운로드하며, 각 파일은 sha256으로 검증합니다.
라이선스
- 가중치: Apache-2.0, © StepFun (모델 카드).
- 추론 코드(
step1x3d_geometry/, GitHub의 커밋cb5ac94): Apache-2.0 (라이선스). - DINOv2 with registers (large) 구성 파일: Apache-2.0, © Meta Platforms (모델 카드). 이 파일의
config.json과preprocessor_config.json만 다운로드하며, 인코더 가중치는 Step1X-3D에 포함되어 있습니다.
필수 저작자 표시: "Step1X-3D © StepFun (Apache-2.0)".
제한 사항: 상업적 사용이 허용됩니다. 가중치를 재배포하려면 Apache-2.0 라이선스 전문과 StepFun의 고지를 포함해야 합니다.
버전
| 버전 | 출시일 | 앱 필요 |
|---|---|---|
| 1.0.4최신 | 0.32.0-beta.6 이상 | |
| 1.0.3 | 0.32.0-beta.6 이상 |
설치
데스크톱 앱에서
Packages 창을 열고(상태 표시줄의 패키지 아이콘) Browse를 선택한 다음 aigd.model3d-step1x-3d-geometry를 검색하고 Add to Project를 클릭합니다.
앱이 아직 없나요? Windows, macOS, Linux용 AI Game Dev 무료 다운로드를 받아보세요.
터미널에서
gamedev CLI를 사용해 프로젝트 폴더에서 실행합니다:
gamedev pkg add aigd.model3d-step1x-3d-geometry요구 사항
- AI Game Dev 0.32.0-beta.6 이상
- 16 GB 이상의 NVIDIA GPU
gamedev pkg add aigd.model3d-step1x-3d-geometry