사진 한 장으로 탐색 가능한 3D 공간과 입체 에셋을 생성하는 클로드 코드 툴킷 'image-blaster'

World Labs 디자인 팀의 닐슨 쾨르너-사프라타(Neilson Koerner-Safrata)가 단 한 장의 2D 이미지에서 탐색 가능한 3D 가우시안 스플랫 환경, 분리된 개별 3D 오브젝트 메시, 공간 배경음과 물리 효과음을 한 번에 구축하는 오픈소스 툴킷 'image-blaster(neilsonnn/image-blaster)'를 공개했습니다. MIT 라이선스로 배포된 이 프로젝트는 클로드 코드(Claude Code)의 스킬(Skills) 아키텍처를 오케스트레이션 계층으로 활용해 복수의 상용 생성형 AI 파이프라인을 5분 이내의 단일 워크플로우로 엮어냅니다.

이미지 출처: @lucian__03 / X

기존의 이미지 기반 3D 생성 도구들이 단일 물체의 메시(.glb) 추출이나 배경 공간의 단순 뎁스 추정에 그쳤던 것과 달리, image-blaster는 장면 안의 동적 사물과 정적 배경을 분리하고 공간 오디오까지 동기화하여 게임 엔진 및 3D DCC 소프트웨어에 즉시 배치할 수 있는 완전한 씬 에셋 번들을 구성한다는 점에서 큰 관심을 모으고 있습니다.

단일 2D 이미지에서 3D 씬·오브젝트·사운드를 동시 추출하는 오케스트레이션 구조

image-blaster의 핵심은 클로드 코드가 지휘하는 다단계 모델 연동 파이프라인에 있습니다. 단일 입력 사진이 주어지면 시스템은 다음과 같은 순서로 각 전문 모델 API를 순차 호출해 에셋을 생성합니다.

1. 동적 객체 분리 및 클린 플레이트 생성 (Nano Banana / GPT Image 2): 원본 사진에서 이동 및 상호작용이 가능한 동적 사물(예: 의자, 바구니, 탁자 위의 소품 등)을 식별해 분리하고, 사물이 제거된 깨끗한 배경 이미지를 복원합니다. 복합적인 사물 묶음 대신 분리 가능한 단일 객체 단위로 분할 분석을 수행합니다.
2. 정적 환경 가우시안 스플랫 구축 (World Labs Marble 1.1): 사물이 제거된 배경 플레이트를 기반으로 3차원 공간을 재구성하여 자유롭게 시점을 이동하며 탐색할 수 있는 가우시안 스플랫(.spz) 포맷의 정적 3D 환경을 생성합니다.
3. 독립 3D 메시 추출 (FAL 호스팅 Tencent Hunyuan 3D): 식별된 각 동적 객체를 개별 3D 입체 메시(.glb, .obj)로 변환합니다. 배경 평면에 붙은 단순 텍스처가 아니라 독립적으로 이동·배치 가능한 온전한 3D 모델로 출력됩니다.
4. 환경음 및 물리 상호작용 사운드 생성 (ElevenLabs SFX): 공간 분위기를 형성하는 루핑 앰비언트 사운드와 사물별 충돌·이동 물리 효과음(.mp3)을 자동 합성해 공간의 현장감을 완성합니다.

이러한 전 과정은 사용자가 로컬 터미널에서 클로드 코드에 blast it and confirm each step with me라는 자연어 지시를 내리는 것만으로 각 단계별 검증을 거치며 매끄럽게 진행됩니다.

Hunyuan 3D 메시 정밀 제어와 범용 3D 파이프라인 호환성

객체 메시 생성 단계에서는 FAL을 통해 서빙되는 텐센트(Tencent)의 Hunyuan 3D 모델 파라미터를 세부적으로 제어할 수 있어 프로토타입 단계에 맞춘 유연한 최적화가 가능합니다.

• 폴리곤 면 수 조절 (--face-count): 타깃 면 수를 40,000개에서 1,500,000개 사이로 지정할 수 있습니다. Hunyuan API의 기본값은 500,000개이지만, image-blaster는 게임 엔진 배치 효율을 고려해 기본 50,000개(LowPoly 최적화)로 자동 설정합니다.
• PBR 재질 생성 (--enable-pbr): 물리 기반 렌더링(PBR) 텍스처 머티리얼 생성을 기본으로 활성화(true)하여 조명 반응성을 보장합니다.
• 메시 스타일 프리셋 (--generate-type): 텍스처가 완전히 입혀진 Normal, 폴리곤 리덕션이 적용된 LowPoly, 텍스처 없이 순수 형태만 추출하는 Geometry 중 프로젝트 목적에 맞춰 선택할 수 있습니다. LowPoly 모드에서는 폴리곤 유형(--polygon-type)을 삼각형(triangle) 또는 사각형(quadrilateral)으로 설정할 수 있습니다.

생성된 출력물은 표준 포맷(.spz, .glb, .obj, .mp3)으로 저장되므로, 별도의 추가 후가공 없이 주요 실시간 엔진과 3D 도구에 즉시 임포트할 수 있습니다.

• 게임 엔진: Unity, Unreal Engine, Godot
• 3D DCC 소프트웨어: Blender, Autodesk Maya, 3ds Max
• 웹 및 데스크톱 런타임: Three.js 기반 웹 애플리케이션, Electron 환경

설치 경로와 실무 활용 시 필수 고려사항

image-blaster는 공식 저장소를 클론하고 클로드 코드를 실행하는 것만으로 손쉽게 환경을 구축할 수 있습니다.

# 저장소 클론 및 이동
git clone https://github.com/neilsonnn/image-blaster
cd image-blaster

# 클로드 코드 실행 (미설치 시 curl -fsSL https://claude.ai/install.sh | bash 로 설치)
claude

실행 후 World Labs, FAL, ElevenLabs의 API 키를 등록하고, 변환하고자 하는 2D 이미지를 input/ 디렉토리에 넣은 뒤 변환 명령을 입력하면 됩니다.

실제 프로젝트에 도입하기 전 다음과 같은 기술적·비용적 특성을 고려해야 합니다.

1. 상용 API 호출 비용 발생: 툴킷 소스코드는 MIT 라이선스 무료 오픈소스이지만, 내부에서 호출하는 World Labs Marble, FAL(Hunyuan 3D), ElevenLabs는 유료 상용 API입니다. 이미지 1장 변환당 약 2달러에서 4달러 수준의 API 크레딧이 소모됩니다.
2. 단일 뷰 3D 재구성의 한계 (Hallucination): 한 장의 2D 사진에서 보이지 않는 후면이나 가려진 영역, 복잡한 실외 공간의 기하 구조는 생성 모델의 추론에 의존합니다. 따라서 벽면 너머나 복잡한 원경에서 기하학적 왜곡이 발생할 수 있습니다.
3. 권장 활용 영역: 최종 상용 프로덕션 에셋으로 직접 사용하기보다는 인디 게임 개발자의 레벨 콘셉트 블록아웃, 3D 배경 기획 초안, 가상 로케이션 스카우팅, 건축 및 전시 공간 프리비즈(Pre-visualization) 등 초기 공간 프로토타이핑을 가속화하는 도구로 활용할 때 생산성 극대화 효과를 얻을 수 있습니다.

출처

• GitHub 저장소: neilsonnn/image-blaster
• World Labs 쇼케이스: Image Blaster | Community Showcase
• 원문 공유 (X @lucian__03): X 게시물