Magiviz: 대본부터 완성 영상까지 자동화하는 오픈소스 AI 영상 제작 엔진

Magiviz는 기획부터 최종 영상 출력까지 전 과정을 한 번에 다루는 오픈소스 AI 영상 제작 플랫폼입니다. 대본 분해, 캐릭터 디자인, 스토리보드, 장면 렌더링, 최종 합성을 단일 웹 애플리케이션으로 구현했습니다.

어떤 기능을 제공하나

핵심 아키텍처는 일시 중지와 재개를 지원하는 5단계 직렬 생성 파이프라인입니다.

첫 번째 단계에서는 줄거리, 영상 길이, 화면 비율을 기반으로 AI가 장면 목록과 캐릭터 묘사, 연출 지시문이 담긴 대본을 생성합니다.

두 번째 단계는 캐릭터 이미지를 병렬로 생성합니다. 참고 이미지 업로드를 지원해 캐릭터 외형의 일관성을 유지할 수 있습니다.

세 번째 단계는 각 장면의 스토리보드를 만듭니다. 해당 장면에 등장하는 캐릭터 이미지만 선별해 입력으로 넘기며, 첫 프레임과 끝 프레임을 따로 지정하는 모드도 지원합니다.

네 번째 단계는 Veo 3.1, Kling 3.0, Seedance 2.0 및 2.5, Wan 3.0, MiniMax H3 등 다양한 모델을 활용해 장면별 영상을 병렬로 렌더링합니다.

다섯 번째 단계에서는 FAL AI를 호출해 렌더링된 모든 영상과 오디오 트랙을 하나의 완성본으로 이어 붙여 내보냅니다.

전체 작업 흐름은 버전 추적을 지원하므로, 마음에 들지 않는 캐릭터나 개별 장면만 골라 다시 생성해도 이전 작업 내역이 덮어씌워지지 않습니다.

또한 NextAuth 인증, Stripe 구독 및 크레딧 결제, 추천인 제도, 다국어 관리자 대시보드 등 상용 SaaS 운영에 필요한 백오피스 기능도 기본 탑재되어 있습니다.

실행 및 배포 방법

Magiviz는 Next.js 15, TypeScript, Tailwind CSS, Drizzle ORM, PostgreSQL 기반으로 제작되었습니다.

영상 생성 작업은 Kie.ai, ZenMux, FAL 등 외부 API를 통해 처리되므로 로컬 환경에 고성능 GPU가 없어도 무방합니다.

실행을 위해서는 Node.js 18 이상과 PostgreSQL 데이터베이스가 필요합니다.

GitHub에서 ItusiAI/Open-Magiviz 저장소를 클론한 뒤 npm install로 의존성을 설치합니다.

.env.example을 .env.local로 복사하고 데이터베이스 주소, NextAuth 시크릿, Stripe 결제 키, AI 서비스 API 키를 입력합니다.

npm run db:push 명령으로 데이터베이스 스키마를 반영하고 npm run dev를 실행하면 로컬에서 바로 구동할 수 있으며, Vercel을 통한 원클릭 배포도 지원합니다.

왜 중요한가

AI 영상 제작 서비스를 구축하려는 1인 개발자나 소규모 창업팀에게 Magiviz는 개발 시간을 대폭 줄여주는 유용한 도구입니다. 복잡한 비동기 작업 상태 관리나 결제 시스템을 처음부터 구현할 필요가 없습니다.

다만 기본 구조상 Kie.ai 같은 타사 API 중계 서비스에 강하게 묶여 있습니다. 사내 ComfyUI 환경이나 자체 GPU 클러스터로 연결하려면 백엔드 연동 코드를 직접 손봐야 합니다. 그럼에도 API 키만 넣으면 즉시 상용 서비스를 운영할 수 있다는 점에서 개발 생산성 측면의 이점이 큽니다.