본문으로 건너뛰기

Image Blaster / 가이드

Image Blaster 퀵스타트: 한 장의 이미지로 3D 세계 만들기

Image Blaster는 Claude를 위한 image-to-world 스킬셋입니다. 원본 이미지를 읽고, 메시로 만들 가치가 있는 오브젝트를 판단하고, 탐험 가능한 환경을 구축하며, 환경음과 오브젝트별 사운드를 생성합니다 — 보통 5분 이내입니다.

필요한 것

.env.example을 .env로 복사하고 WORLD_LABS_API_KEY와 FAL_KEY를 입력하세요.

블라스트 실행하기

  1. 터미널을 열고 cd image-blaster.
  2. claude를 실행하고 요청받으면 두 API 키를 전달합니다.
  3. input/ 디렉터리에 이미지를 넣습니다.
  4. Claude에게 blast it and confirm each step with me라고 말합니다.

Claude는 worlds/<slug> 아래에 프로젝트를 준비하고, 원본 이미지를 분석하고, 오브젝트 목록을 함께 확인한 뒤 세계, 메시, 클린 플레이트, 효과음을 생성합니다.

결과물

기본적으로 Image Blaster 블라스트는 다음을 생성합니다:

  • 모든 동적 오브젝트의 3D 모델(.glb, .obj)
  • 정적 환경의 가우시안 스플랫(.spz)
  • 전경 오브젝트를 제거한 클린 플레이트
  • 루프 환경음과 오브젝트별 물리 SFX(.mp3)

모든 것이 worlds/<slug> 아래 디스크에 기록됩니다. JSON 사이드카의 프로바이더 URL은 출처 및 재개 메타데이터일 뿐이므로, 생성 에셋은 오프라인에서도 계속 동작합니다.

뷰어로 확인하기

Image Blaster는 app/에 React와 react-three-fiber 뷰어를 포함합니다. 저장소 루트에서 bun install && bun run dev를 실행하고 출력된 URL을 열면 세계를 걷고, 각 메시를 확인하고, 오디오를 재생할 수 있습니다.

메시 조정하기

Image Blaster의 image-blast-3d 스킬은 Hunyuan 파라미터를 그대로 전달합니다:

파라미터값기본값
--face-count40000–150000050000
--enable-pbrtrue / falsetrue
--generate-typeNormal / LowPoly / GeometryNormal
--polygon-typetriangle / quadrilateraltriangle

게임 엔진에 더 가벼운 메시가 필요하면 LowPoly, 흰색 지오메트리 패스만 원하면 Geometry를 선택하세요.

더 활용하기

  • 이미지 편집 프로바이더를 nano-banana와 gpt-image-2 사이에서 전환합니다.
  • image-blast-wildcard 스킬로 확인 후 거의 모든 FAL 모델을 실행합니다.
  • 3D 스킬의 --provider를 바꿔 Hunyuan 대신 Meshy를 시도합니다.

수정이 필요할 때는 생성 파일을 직접 편집하지 말고 올바른 스킬을 찾아 다시 실행하세요 — Image Blaster의 스킬이 프로젝트 상태와 출처의 일관성을 유지합니다.