3DCellForge: 참조 이미지를 인터랙티브 3D 모델로 만드는 웹 스튜디오

9bow · 6월 16, 2026, 2:30오전

3DCellForge 소개

이미지 한 장을 3D 모델로 바꿔 주는 생성 모델은 빠르게 늘었지만, 막상 생성한 모델을 한 화면에서 돌려 보고 품질을 따지고 발표 자료로 다듬는 작업대는 흔치 않습니다. 3DCellForge 는 이 부분을 메우려는 React와 Three.js 기반 프로토타입으로, 업로드한 참조 이미지나 GLB 파일을 인터랙티브한 3D 작업 공간으로 만들어 주는 웹 스튜디오입니다. 저장소 이름은 3DCellForge이고, 앱 화면에서는 "3D Model Studio"라는 이름으로 표시됩니다.

3DCellForge의 중심에는 React Three Fiber로 만든 모델 뷰어가 있습니다. 마우스를 끌어 회전하고 스크롤로 확대하며, 구조의 일부만 분리해 살펴보거나 모델 세부 정보를 확인하고 현재 장면을 내보낼 수 있습니다. 화면은 왼쪽의 모델 라이브러리, 가운데의 WebGL 무대(stage), 오른쪽의 에셋·생성 도구로 이루어진 3단 워크벤치 구조입니다. 참조 이미지를 올리면 여러 이미지-투-3D(image-to-3D) 프로바이더 중 하나로 실제 3D 모델을 생성할 수 있고, 결과물은 GLB로 내보낼 수 있습니다.

단, 현재 3DCellForge 프로젝트는 아직 프로토타입 단계임을 분명히 밝히고 있습니다. 그럼에도 생성 큐, 업로드 기록, 품질 점수, 데모 발표 모드처럼 "생성 이후"를 다루는 기능이 갖춰져 있어, 단순 생성 데모를 넘어 만든 모델을 검수하고 보여 주는 흐름까지 한 화면에서 시험해 볼 수 있습니다. 본 게시물에서는 3DCellForge의 워크벤치 구성, 지원하는 생성 프로바이더, 기술 스택과 데이터 보존 방식, 그리고 설치·실행 방법을 정리합니다.

3DCellForge의 워크벤치와 데모 모드

3DCellForge의 기본 화면은 의도적으로 조용하게 구성됩니다. 왼쪽 Model Library 레일에서 활성 모델을 고르고, 이전에 만든 모델은 펼치기 전까지 Saved Assets 아래에 접혀 있습니다. 오른쪽 Asset Source 레일에서 생성 프로바이더를 고르거나 로컬 .glb 또는 .gltf 파일을 가져오고, 업로드와 생성, 가져오기 상태는 왼쪽 Generation Queue 패널에서 확인합니다. 부품 상세 정보는 Info 나 Inspect 를 눌렀을 때만 열리는 서랍(drawer)으로 나타납니다.

생성한 GLB에는 파일 크기, 삼각형 수, 텍스처 수, 데모 준비도를 종합한 모델 품질 점수가 매겨지고, 무대의 품질 카드에서 점수가 낮으면 보통 원본 이미지나 프로바이더 결과가 발표에 쓸 만큼 다듬어지지 않았다는 신호로 해석합니다. 상단 내비게이션의 Demo 를 누르면 발표 모드로 들어가는데, 이때 측면 패널을 숨기고 객체 인식 기반의 영화적 카메라 경로를 사용하며 깔끔한 발표 오버레이를 보여 줍니다. 데모 애니메이션은 모델 이름과 메타데이터에 맞춰 달라집니다. 자동차는 도로 위로 밀고 들어가는 동선, 항공기는 비행 패스, 선박은 항해 순항, 유기체나 표본 에셋은 스튜디오 궤도(orbit) 회전을 사용합니다.

3DCellForge의 이미지-투-3D 생성 프로바이더

3DCellForge는 한 가지 모델에 묶이지 않고 여러 이미지-투-3D 백엔드를 선택해 쓸 수 있습니다. 업로드 패널에서 파일을 고르기 전에 생성 모드를 정할 수 있는데, Hyper3D(Rodin), Tripo, Fal.ai, 로컬 Hunyuan3D, 브라우저에서 도는 JS Depth, 그리고 기존 .glb/.gltf 를 가져오는 Local GLB 모드를 제공합니다. Auto 모드는 Hyper3D를 먼저 시도하고 실패하면 Tripo, Fal, Hunyuan, JS Depth 순으로 폴백합니다. Fal.ai 경로에서 고를 수 있는 모델은 Hunyuan3D v2, TRELLIS, TripoSR, Tripo3D v2.5, Hyper3D Rodin입니다.

선택 사항으로 OpenAI API 키를 설정하면 업로드 이미지가 비전(vision) 분석을 거칩니다. /api/3d/analyze 엔드포인트가 업로드를 에셋 유형, 재질 초점, 검수 노트, 장면 프로파일, 태그, 그리고 더 나은 이미지-투-3D 프롬프트로 분류해 줍니다. 키가 없으면 파일명과 메타데이터 기반의 로컬 휴리스틱으로 대신 동작합니다. 또한 모델 검수에 쓰이는 객체 인식 인스펙터는 추론된 카테고리, 출처, 프로바이더 상태, 재질 초점, 데모 가치, 태그를 차량·항공기·선박·제품·유물·유기 표본 같은 범주에 맞춰 보여 줍니다.

3DCellForge의 기술 스택과 데이터 보존

3DCellForge는 React, Vite, Three.js, React Three Fiber, Drei, Framer Motion으로 프론트엔드를 구성하고, 선택적 백엔드로 Tripo API, Fal.ai, 로컬 Hunyuan3D API를 연결합니다. 생성한 GLB는 Node 백엔드가 .generated-models/ 아래에 캐시하므로, 이후에 볼 때는 임시 프로바이더 URL 대신 로컬 사본을 사용합니다. 프론트엔드의 모델 라이브러리는 IndexedDB에 저장되어, 생성하거나 가져온 모델 기록이 페이지를 새로 고쳐도 유지되고 localStorage가 간결한 폴백으로 함께 쓰입니다.

보안 측면에서는 API 키를 프론트엔드 코드에 두지 않고 git이 무시하는 .env.local 에 서버 측 비밀로 보관하며, 키가 프론트엔드 번들에 노출되지 않도록 합니다. 저장소에는 API 크레딧을 매번 쓰지 않고도 데모를 돌릴 수 있도록 캐시된 GLB 모델이 public/generated-models/ 아래에 포함되어 있고, 재질과 로더 점검용으로 Khronos glTF 샘플 모델을 라이브러리 패널에서 보조 참조로 불러옵니다.

3DCellForge 설치 및 사용법

설치는 의존성을 받고 개발 서버를 띄우는 것으로 시작합니다.

npm install
npm run dev

터미널에 표시된 Vite URL을 열면 됩니다. 이미지-투-3D 생성을 켜려면 .env.example 을 복사해 .env.local 을 만들고 사용할 프로바이더의 키를 채웁니다.

cp .env.example .env.local

TRIPO_API_KEY, FAL_API_KEY, RODIN_API_KEY, OPENAI_API_KEY 등을 설정할 수 있으며, OPENAI_API_KEY 는 앞서 설명한 이미지 이해 기능(/api/3d/analyze)을 활성화합니다. 로컬 Hunyuan3D 백업 모드를 쓰려면 로컬 Hunyuan3D API 서버를 띄우고 HUNYUAN_API_BASE 같은 값을 지정합니다. 생성 백엔드는 별도로 실행합니다.

npm run dev:api

프론트엔드는 기본적으로 http://127.0.0.1:8787 의 로컬 Node 백엔드와 통신합니다. 이 밖에 npm run lint, npm run build, npm run test, 그리고 워크벤치와 모델 라이브러리 서랍, 데모 모드의 레이아웃·스크린샷 회귀를 점검하는 npm run test:visual 같은 검증 명령도 제공됩니다.

3DCellForge의 라이선스

3DCellForge는 MIT 라이선스로 공개되어 있어 개인 및 상업적 목적으로 자유롭게 사용할 수 있습니다.

3DCellForge 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다!
텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다.

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~