TripoSG 1.5B (로컬 3D 모델)
gamedev pkg add aigd.model3d-triposg개요
로컬 이미지→3D: VAST-AI의 TripoSG 1.5B는 이미지 한 장을 선명하고 깔끔한 표면을 지닌 상세한 무텍스처 3D 메시(GLB)로 변환하며, 8 GB VRAM의 NVIDIA GPU에서 실행됩니다. Local Python models runtime에서 오프라인으로 동작합니다. 가중치는 MIT이며, 추론에 포함된 Tencent 코드는 유럽연합, 영국, 대한민국에서 라이선스되지 않습니다.
TripoSG 1.5B는 VAST-AI의 TripoSG를 사용해 이미지 한 장을 NVIDIA GPU(8 GB 이상의 VRAM)에서 상세한 3D 형상으로 바꿉니다. 결과물은 선명하고 깔끔한 표면을 지닌 무텍스처 GLB입니다. AI Game Dev에서는 Local Python models runtime(aigd.python)을 통해 로컬로 실행됩니다. 로컬 이미지→3D 모델 중 비디오 메모리를 가장 적게 요구합니다. 추론 코드 일부에는 유럽연합, 영국, 대한민국에서의 사용을 허용하지 않는 Tencent 라이선스가 적용됩니다.
만들 수 있는 것
- 이미지 한 장으로 소품, 무기, 차량, 생물, 캐릭터의 무텍스처 메시를 만듭니다.
- 나중에 텍스처를 입히거나 리토폴로지·리깅할 베이스 메시입니다.
- 8 GB NVIDIA 카드에서 콘셉트 아트를 바탕으로 3D 블록아웃을 만들 수 있습니다.
요청 예시
- "TripoSG로
Concepts/lantern.png의 3D 모델을 만들어 주세요." - "투명 배경의 로봇 콘셉트를 GLB로 변환해 주세요."
- "
Concepts/rocks/에 있는 세 장의 바위 이미지 각각에 대해 메시를 생성해 주세요."
주요 사항
| 모델 ID | aigd.model3d-triposg.v1 |
| 작업 | 이미지→3D (입력 이미지 한 장, 투명 배경이 가장 잘 작동합니다) |
| 출력 | 무텍스처 GLB |
| 스텝 | 기본 50 |
| 실행 환경 | 8 GB 이상의 VRAM을 갖춘 NVIDIA GPU (CUDA) |
| 다운로드 | 약 7.9 GB, 최초 로드 시 런타임의 Python 환경 별도 |
| 라이선스 | 가중치 MIT; 추론 코드 일부에 Tencent 라이선스 적용: 유럽연합, 영국, 대한민국에서는 사용 불가, 월간 활성 사용자 100만 명 초과 시 별도 라이선스 필요 |
다른 로컬 이미지→3D 모델
- Hunyuan3D-2.1 Shape: 무텍스처, VRAM 10 GB.
- Step1X-3D Geometry: 무텍스처, VRAM 16 GB, 지역 제한 없는 Apache-2.0.
- TRELLIS.2 4B 및 Pixal3D: PBR 소재가 적용된 텍스처 GLB, NVIDIA 또는 Vulkan GPU에서 16 GB.
실행 방식
투명 배경에 객체 하나가 있는 이미지를 사용하세요. 앱이 이미지를 객체에 맞춰 자릅니다. 불투명 이미지는 전체가 사용되며, 객체가 단순한 배경을 가득 채울 때만 제대로 동작합니다. 배경 제거 모델은 포함되어 있지 않습니다(TripoSG 자체 모델인 RMBG-1.4는 비상업용입니다). 더 빠른 "flash" 디코더는 사용하지 않습니다. 이 디코더에는 diso이 필요하며, 이는 비상업용(CC BY-NC 4.0)이고 컴파일해야 합니다.
출력에는 분리된 작은 부분이 포함될 수 있습니다. 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.9 GB, Hugging Face 리비전 및 sha256으로 고정:
| 파일 | 크기 | 라이선스 | 출처 |
|---|---|---|---|
feature_extractor_dinov2-preprocessor_config.json | 0.00 GB | MIT | 파일 |
image_encoder_dinov2-config.json | 0.00 GB | MIT | 파일 |
image_encoder_dinov2-model.safetensors | 1.22 GB | MIT | 파일 |
model_index.json | 0.00 GB | MIT | 파일 |
scheduler-scheduler_config.json | 0.00 GB | MIT | 파일 |
transformer-config.json | 0.00 GB | MIT | 파일 |
transformer-diffusion_pytorch_model.safetensors | 5.76 GB | MIT | 파일 |
vae-config.json | 0.00 GB | MIT | 파일 |
vae-diffusion_pytorch_model.safetensors | 0.97 GB | MIT | 파일 |
모델의 Python 코드는 고정된 커밋의 GitHub에서 다운로드되며, 각 파일은 sha256으로 검사됩니다.
라이선스
- 가중치: MIT, © 2025 VAST-AI-Research 및 기여자(모델 카드).
- 추론 코드(
triposg/, GitHub의 커밋fc5c409에서 다운로드): 저장소는 MIT이지만, 해당 저장소의triposg/폴더에는 Tencent Hunyuan FlashVDM Community License가 적용되며, 해당 저장소의 NOTICE에는 Tencent Hunyuan FlashVDM 및 HunyuanDiT에서 파생된 코드가 나열되어 있습니다.
필수 출처 표시: "TripoSG © 2025 VAST-AI-Research and contributors. Tencent Hunyuan FlashVDM is licensed under the Tencent Hunyuan FlashVDM Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. Tencent Hunyuan is licensed under the Tencent Hunyuan Community License Agreement, Copyright © 2024 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."
제한 사항(추론 코드 일부에 적용되는 Tencent 라이선스 기준):
- 유럽연합, 영국, 대한민국에서는 라이선스되지 않습니다. 해당 지역에서 코드나 그 출력물을 사용할 수 없습니다.
- 월간 활성 사용자 100만 명 초과인 제품이나 서비스는 Tencent의 별도 라이선스가 필요합니다.
- 이 코드와 그 출력물은 다른 AI 모델을 개선하는 데 사용할 수 없습니다.
- Tencent의 허용 사용 정책이 적용됩니다.
사용이 허용되는지 확인할 책임은 사용자에게 있습니다.
버전
| 버전 | 출시일 | 앱 필요 |
|---|---|---|
| 1.0.4최신 | 0.32.0-beta.6 이상 | |
| 1.0.3 | 0.32.0-beta.6 이상 |
설치
데스크톱 앱에서
Packages 창을 열고(상태 표시줄의 패키지 아이콘) Browse를 선택한 다음 aigd.model3d-triposg를 검색하고 Add to Project를 클릭합니다.
앱이 아직 없나요? Windows, macOS, Linux용 AI Game Dev 무료 다운로드를 받아보세요.
터미널에서
gamedev CLI를 사용해 프로젝트 폴더에서 실행합니다:
gamedev pkg add aigd.model3d-triposg요구 사항
- AI Game Dev 0.32.0-beta.6 이상
- 8 GB 이상의 NVIDIA GPU
gamedev pkg add aigd.model3d-triposg