Topview 3D Builder: 자연어 프롬프트로 3D 장면과 카메라 동선을 설계하는 로컬 오픈소스 도구
Claude Code, Cursor, ChatGPT 등 AI 에이전트와 연동해 3D 공간 연출과 멀티 카메라 동선을 잡는 오픈소스 도구 Topview 3D Builder의 구조와 활용법을 정리합니다.
AI 영상 생성 도구에서 원하는 구도와 카메라 동선을 텍스트 프롬프트만으로 정확히 맞추기는 쉽지 않습니다. 등장인물 위치나 카메라 앵글이 매번 무작위로 바뀌면서 프롬프트 수정과 재생성을 반복해야 하는 한계가 따랐습니다. 2026년 9월 24일 공개된 오픈소스 프로젝트 Topview 3D Builder(topviewai/topview-3d-builder)는 이 문제를 해결하기 위해 AI 코딩 에이전트를 3D 연출 보조자로 활용하는 접근 방식을 제안합니다.

이미지 출처: https://github.com/topviewai/topview-3d-builder
Apache License 2.0으로 배포되는 Topview 3D Builder는 로컬 환경에서 설치해 사용하는 도구입니다. 복잡한 3D 그래픽 툴을 직접 다루지 않고도 자연어 프롬프트나 참고 이미지 한 장으로 3D 공간을 구성하고, 인물 배치와 시선 처리, 카메라 이동 경로를 미리 시각화할 수 있습니다.
3D 스테이징으로 제어하는 영상 구도와 카메라 워크
Topview 3D Builder의 핵심은 비디오 파운데이션 모델에 렌더링을 맡기기 전, 3D 가상 스튜디오 단계에서 연출을 미리 검증하도록 돕는 데 있습니다.
일반적인 텍스트-투-비디오(Text-to-Video) 작업에서는 인물 사이의 거리나 카메라 이동 궤적을 텍스트로 온전히 표현하기 어렵습니다. 이 도구는 기본 제공되는 3D 캐릭터 에셋과 포즈, 소품, 카메라 객체를 배치해 공간 구도를 먼저 고정합니다.
- 독립된 3D 씬 편집: 씬 전체가 저장 가능한 프로젝트 형태로 관리됩니다. 인물 위치를 조금 바꾸거나 포즈를 수정해도 전체 구도를 처음부터 다시 만들 필요가 없습니다.
- 사전 공간 계측: 인물이 지면에 뜨거나 사물과 겹치는 현상, 프레임 이탈 여부를 도구가 자동으로 측정해 영상 생성 전 오류를 잡아냅니다.
- 다중 카메라 렌더링: 하나의 3D 장면 안에서 정면 샷, 오버 더 숄더(OTS) 샷, 탑다운 샷 등 복수의 앵글을 추출해 컷 전환 시 인물 위치와 공간 일관성을 유지합니다.
- 타임라인 기반 카메라 제어: 푸시인(Push-in), 풀백(Pull-back), 트래킹, 궤도 회전(Orbit) 등 초 단위 카메라 이동을 타임라인에서 직접 설계합니다.
3D 장면 구성과 멀티 카메라 사전 렌더링 과정은 별도의 계정 가입이나 외부 클라우드 업로드 없이 로컬 머신에서 무료로 처리됩니다. 다만 완성된 3D 씬을 실제 애니메이션 비디오로 최종 변환하는 단계에서는 Topview.ai 등 외부 비디오 생성 모델 연동이 필요합니다.
시스템 요구 사양과 에이전트 연동 방법
Topview 3D Builder를 구동하려면 로컬 환경에 다음 런타임이 갖춰져 있어야 합니다.
- Python: 3.11 이상
- Node.js: 20.6 이상
- 패키지 관리자:
uv또는pipx
사용 중인 AI 코딩 도구나 에이전트 인터페이스에 맞춰 플러그인 또는 스킬 형태로 설치할 수 있습니다.
Claude Code 연동
터미널에서 플러그인 저장소를 등록하고 패키지를 설치한 뒤 Claude Code를 재시작합니다.
claude plugin marketplace add https://github.com/topviewai/topview-3d-builder.git
claude plugin install topview-3d-builder@topview-3d-builder
Cursor 연동
로컬 플러그인 디렉터리에 저장소를 클론한 후 Cursor를 재시작합니다.
git clone https://github.com/topviewai/topview-3d-builder.git ~/.cursor/plugins/local/topview-3d-builder
ChatGPT / Codex 및 범용 스킬 지원 에이전트
ChatGPT와 Codex 환경에서는 제공되는 플러그인 페이지에서 직접 설치를 진행할 수 있습니다. Qoder 등 스킬(skills) 프로토콜을 지원하는 에이전트 환경에서는 다음 명령어로 등록합니다.
npx skills add https://github.com/topviewai/topview-3d-builder.git
설치 후 topview-3d-cli를 선택하면 첫 실행 시 브라우저 렌더링 컴포넌트가 로컬에 다운로드되어 캐시 처리됩니다. 프로젝트 문서에서는 가성비와 작업 속도 측면에서 Qwen 3.8 Flash 모델 사용을 추천하고 있습니다.
작업 흐름: 프롬프트에서 카메라 렌더링까지
설치 후 에이전트 세션을 열고 다음과 같이 원하는 장면을 지시합니다.
Build a scene: a character sits next to a box. Render a front view.
참고 이미지를 입력하면서 세부 카메라 이동 경로를 지정할 수도 있습니다.
Build the 3D scene from the reference image.
0s: Pull back from the leaning man to show both men and the car.
3s: Over-the-shoulder push-in to the engine.
5s: Fixed first-person shot of the engine.
에이전트는 요청된 지시문에 따라 내장 에셋을 조합해 3D 씬을 생성하고 카메라 위치를 설정합니다. 사용자는 에이전트와의 추가 대화를 통해 소품 위치를 조정하거나, 로컬 Studio 화면을 열어 마우스 드래그로 직접 오브젝트를 옮길 수 있습니다. 배치가 확정되면 멀티 카메라 구도를 렌더링하고 비디오 모델 입력용 결과물을 내보냅니다.
텍스트 프롬프트의 확률적 결과에만 의존하던 기존 비디오 생성 파이프라인에서, 3D 사전 시각화(Pre-visualization)를 로컬 에이전트 워크플로에 끌어들였다는 점이 이 도구의 실질적인 차별점입니다.
출처
- GitHub: topviewai/topview-3d-builder
- X (@Lucy_love_AI): Topview 3D Builder 소개 게시물