Repolode
ahujasid

ahujasid/camera-to-blender

휴대폰으로 실물 사진을 찍고 생성된 3D 모델을 Blender로 바로 가져오세요.

스타
1,409
포크
165
열린 이슈
1
마지막 커밋
2개월 전

어떤 프로젝트인가요?

Camera to 3D는 실물 사진을 Blender 안에서 사용할 수 있는 3D 모델로 변환하는 파이프라인입니다. 사진은 선택적으로 배경을 제거한 뒤 Tripo3D API로 전송되어 모델 생성에 사용되며, 생성된 모델은 WebSocket 연결을 통해 Blender 애드온으로 전달되어 자동으로 가져옵니다.

시스템은 두 부분으로 구성됩니다. Python FastAPI 서버는 Blender가 실행 중인 컴퓨터에서 동작하며 API 호출과 모델 전달을 처리합니다. 모바일 환경에 맞춘 웹 앱은 카메라 인터페이스를 제공합니다. 휴대폰 브라우저에서 카메라를 사용하려면 HTTPS가 필요하므로, 설정 과정에서 ngrok으로 로컬 서버를 외부에 공개하고 같은 URL을 Blender 애드온의 WS Import 패널에 붙여 넣습니다.

모델을 생성하려면 Tripo3D API 키가 필요합니다. Gemini API 키는 선택 사항이며, 비워 두면 배경을 제거하지 않고 사진을 사용합니다. ngrok 없이 서버를 로컬에서 실행하면 휴대폰 대신 노트북 웹캠을 사용할 수 있습니다.

핵심 기능

  • 01휴대폰 브라우저 또는 노트북 웹캠으로 사진을 촬영합니다.
  • 02Gemini API를 사용해 사진 배경을 선택적으로 제거합니다.
  • 03Tripo3D API를 통해 3D 모델을 생성합니다.
  • 04WebSocket 애드온을 통해 완성된 모델을 Blender로 자동 가져옵니다.
  • 05HTTPS로 휴대폰에서 접속할 수 있도록 ngrok 설정 방법을 제공합니다.

활용 사례

  • 일상적인 물체를 스캔해 Blender에서 참고용 또는 시작용 메시로 활용합니다.
  • 실제 소품을 빠르게 3D 장면에 가져와 프리비주얼라이제이션에 활용합니다.
  • 직접 모델링하지 않고 3D 에셋의 프로토타입을 만듭니다.

빠른 시작

  1. 1

    Python 종속 항목을 설치합니다

    pip install -r requirements.txt
  2. 2

    릴레이 서버를 시작합니다

    uvicorn relay_server:app --host 0.0.0.0 --port 8000
  3. 3

    두 번째 터미널에서 ngrok을 사용해 서버를 HTTPS로 공개합니다

    ngrok http 8000
  4. 4

    Blender에 WS Import 애드온을 설치하고 ngrok URL에 연결합니다

사용 전 알아둘 점

  • 3D 모델을 생성하려면 Tripo3D API 키가 필요합니다.
  • 휴대폰 카메라에는 HTTPS가 필요하므로 휴대폰에서 사용하려면 ngrok이 필요합니다.
  • 무료 ngrok URL은 재시작할 때마다 변경되므로 매번 Blender를 다시 연결해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

camera-to-blender은(는) 무엇인가요?
휴대폰으로 실물 사진을 찍고 생성된 3D 모델을 Blender로 바로 가져오세요. Camera to 3D는 실물 사진을 Blender 안에서 사용할 수 있는 3D 모델로 변환하는 파이프라인입니다. 사진은 선택적으로 배경을 제거한 뒤 Tripo3D API로 전송되어 모델 생성에 사용되며, 생성된 모델은 WebSocket 연결을 통해 Blender 애드온으로 전달되어 자동으로 가져옵니다.
camera-to-blender은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
camera-to-blender은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
camera-to-blender은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. camera-to-blender의 마지막 커밋은 2026년 9월 5일입니다.
camera-to-blender은(는) 어디에 사용할 수 있나요?
일상적인 물체를 스캔해 Blender에서 참고용 또는 시작용 메시로 활용합니다. 실제 소품을 빠르게 3D 장면에 가져와 프리비주얼라이제이션에 활용합니다. 직접 모델링하지 않고 3D 에셋의 프로토타입을 만듭니다.
camera-to-blender는 어떻게 설치하나요?
Python 종속 항목을 설치합니다: pip install -r requirements.txt 릴레이 서버를 시작합니다: uvicorn relay_server:app --host 0.0.0.0 --port 8000 두 번째 터미널에서 ngrok을 사용해 서버를 HTTPS로 공개합니다: ngrok http 8000 Blender에 WS Import 애드온을 설치하고 ngrok URL에 연결합니다
camera-to-blender은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ahujasid/camera-to-blender

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트