로컬 AI 가이드

사기 전에 속도와 비용부터

모델별 실행 레시피

최종 업데이트

TRELLIS.2로 사진 한 장에서 3D 에셋 만들기

Linux와 24GB 이상 NVIDIA GPU부터 확인해요.

TRELLIS.2는 한 장의 입력 이미지에서 재질이 있는 3D 에셋을 만드는 4B 파라미터 모델이에요. 공식 예제는 입력 사진을 읽고 sample.glb와 미리보기 sample.mp4를 저장해요. 저장소가 안내하는 최소 NVIDIA GPU1 메모리는 24GB이며 Linux 환경을 사용해요.

목차
실행 조건과 핵심 내용
  • TRELLIS.2는 입력 사진에서 3D 형상과 PBR 재질을 생성해요.
  • 실행 전에 Linux, CUDA, 24GB 이상 NVIDIA GPU를 확인해요.
  • 정상 결과는 sample.glb와 sample.mp4예요.

사진과 장비 조건을 먼저 맞춰요

TRELLIS.2는 단일 이미지에서 3D 형상과 재질을 생성하는 모델이에요. 입력에는 물체가 분명히 보이고 배경과 겹치지 않는 사진을 사용해요. 저장소는 Linux 환경, CUDA2 Toolkit 12.4 권장, NVIDIA GPU 메모리 24GB 이상을 요구하며 A100/H100에서 테스트했다고 밝혀요. 따라서 이 설치는 그 조건을 갖춘 Linux GPU를 기준으로 해요. 공식 TRELLIS.2 저장소

제품 사진의 형태와 재질을 살펴보는 이미지 작업 화면
사진 한 장의 형태와 재질 단서를 3D 생성 입력으로 써요.

저장소와 환경을 준비해요

공식 저장소는 하위 모듈을 포함해 복제하고 setup.sh를 실행해 의존성을 설치해요. README는 Python 3.8 이상과 CUDA Toolkit 12.4를 권장하며, CUDA 확장 설치에는 시간이 걸릴 수 있어요. 아래 스크립트는 Linux 쉘에서 실행하고 체크포인트3 다운로드에는 Hugging Face 접근이 필요해요.

공식 설치 스크립트
git clone -b main https://github.com/microsoft/TRELLIS.2.git --recursive
cd TRELLIS.2
. ./setup.sh --new-env --basic --flash-attn --nvdiffrast --nvdiffrec --cumesh --o-voxel --flexgemm

예제 이미지를 GLB로 바꿔요

설치가 끝나면 공식 example.py를 실행해요. 파일의 Image.open('assets/example_image/T.png')에서 기본 입력 경로를 내 사진 경로로 바꾸고 저장해요. microsoft/TRELLIS.2-4B 가중치가 형상을 만들며, 실행 폴더에 sample.glb와 회전 미리보기 sample.mp4를 저장해요.

샘플 3D 에셋 생성
# Edit example.py: replace Image.open('assets/example_image/T.png') with your photo path
python example.py
# Outputs: sample.glb and sample.mp4
제품 이미지와 시안을 함께 준비한 로컬 작업대
제품 사진을 정면에서 고르면 결과 형태를 점검하기 쉬워요.

GLB의 형상과 면을 직접 점검해요

명령이 끝나면 sample.glb를 3D 뷰어에서 열어 회전해요. 뒷면과 얇은 부분, 구멍 주변의 형상이 이어지는지 살펴보고, sample.mp4 미리보기가 아니라 전달할 GLB 파일 자체를 마지막으로 검사해요.

정확한 치수가 필요한 제품 도면이나 측정용 모델이라면 사진 한 장으로 만든 GLB를 그대로 쓰지 마세요. 형태를 빠르게 잡아 보는 용도와, 실제 제작에 쓰는 모델은 준비 방법이 달라요.

서로 다른 크기의 이미지 결과물을 비교하는 판
모델을 만든 뒤 GLB를 뷰어에서 회전해 확인해요.

용어 각주

  1. GPU — 많은 계산을 병렬로 처리하는 프로세서입니다. AI 모델 실행에서는 모델 계산을 맡습니다.

    본문으로 돌아가기

  2. CUDA — NVIDIA GPU에서 범용 계산을 실행하기 위한 소프트웨어 플랫폼입니다.

    본문으로 돌아가기

  3. 체크포인트 — 학습된 모델의 가중치 등을 저장한 파일입니다. 같은 모델 계열도 버전이나 용도에 따라 다른 체크포인트를 쓸 수 있습니다.

    본문으로 돌아가기

자주 묻는 질문

이 글에서 가장 먼저 확인할 것은 무엇인가요?
TRELLIS.2는 한 장의 입력 이미지에서 재질이 있는 3D 에셋을 만드는 4B 파라미터 모델이에요. 공식 예제는 입력 사진을 읽고 `sample.glb`와 미리보기 `sample.mp4`를 저장해요. 저장소가 안내하는 최소 NVIDIA GPU 메모리는 24GB이며 Linux 환경을 사용해요.
필요한 메모리는 어느 정도인가요?
TRELLIS.2는 단일 이미지에서 3D 형상과 재질을 생성하는 모델이에요. 입력에는 물체가 분명히 보이고 배경과 겹치지 않는 사진을 사용해요. 저장소는 Linux 환경, CUDA Toolkit 12.4 권장, NVIDIA GPU 메모리 24GB 이상을 요구하며 A100/H100에서 테스트했다고 밝혀요. 따라서 이 설치는 그 조건을 갖춘 Linux GPU를 기준으로 해요. [공식 TRELLIS.2 저장소](https://github.com/microsoft/TRELLIS.2)