← 프로젝트 아카이브CASE / 019
Cognitive · 인지 / Generative AI
AI Music Video Generation Platform
1인 개발로 진행한 AI 음악 비디오 생성 플랫폼입니다. 아이디어(가사/컨셉)→음원/영상 생성→후처리→업로드까지를 비동기 워크플로우로 자동화해, ‘제작 파이프라인’을 제품화하는 것을 목표로 했습니다.
- 역할
- 1인 개발 · 아키텍처, 구현, 운영 도구
- 기간
- 2025.12 - Present
- 맥락
- Personal Project
01 / 핵심 요약
1인 개발로 진행한 AI 음악 비디오 생성 플랫폼입니다. 아이디어(가사/컨셉)→음원/영상 생성→후처리→업로드까지를 비동기 워크플로우로 자동화해, ‘제작 파이프라인’을 제품화하는 것을 목표로 했습니다.
DECISION / A시스템 과제
무엇이 시스템을 어렵게 만들었는가.
외부 생성 작업이 장시간 실행되므로 비동기 오케스트레이션, 재시도, 진행률/상태 관리가 핵심이었습니다.
DECISION / B엔지니어링 해법
어떤 경계와 흐름으로 답했는가.
FastAPI + Celery/Redis로 생성 파이프라인을 구성하고, FFmpeg 기반 합성/자막 후처리와 업로드 비동기 작업을 통합했습니다.
02 / 시스템 경로
시스템을 통과하는 책임의 경로.
Music Generator
Audio Generation
Responsibilities
- — Lyrics/style-based generation
- — Auto-retry mechanism
- — Status tracking
Video Pipeline
Video Generation & Editing
Responsibilities
- — Long-running task management
- — Audio-video sync
- — Effects pipeline
03 / 기술 필드
01Python02FastAPI03PostgreSQL04Celery05Redis06React07TypeScript08FFmpeg09MoviePy
04 / 상세 기록
개요
- 1인 개발로 진행한 AI 음악 비디오 생성 플랫폼입니다.
- 음악/영상 생성 → 후처리(합성/자막 등) → 업로드까지를 비동기 워크플로우로 자동화했습니다.
핵심 파이프라인
1) API/워크플로우 오케스트레이션
- FastAPI로 작업 생성/조회/상태 관리를 제공합니다.
- 장시간 실행되는 외부 생성 작업은 워커로 분리해 API 응답을 블로킹하지 않도록 구성했습니다.
사용자 플로우(제작 파이프라인)
- 프로젝트 생성 → 음악 생성 → 영상 생성 → 편집/합성(자막/오버레이 포함) → 업로드까지 “단계별 상태”로 추적합니다.
2) 비동기 작업 처리
- Celery + Redis로 생성/후처리/업로드 같은 장시간 작업을 큐로 처리합니다.
- 단계별 상태(예: 생성 중/후처리 중/완료/실패)를 저장하고 재시도/복구 흐름을 갖춥니다.
3) 미디어 후처리
- FFmpeg/MoviePy로 오디오·비디오 합성, 컷/렌더링, 자막 등 후처리를 수행합니다.
4) 업로드 자동화
- 업로드 작업을 워크플로우에 포함해 결과물을 게시 흐름까지 연결합니다.
운영 포인트
- 외부 API 의존 작업은 실패가 전제이므로 상태 추적, 재시도, 멱등성/중복 처리 방지가 핵심입니다.
05 / 실제 증거
ACTUAL PROJECT ASSET / NOT GENERATED