xhongc/ai_story

AI Story – AI 기반 스토리 영상 생성 플랫폼

소개

짧은 텍스트 프롬프트(스토리 주제나 개요)를 완전한 짧은 영상으로 변환하는 웹 애플리케이션입니다. 시스템이 자동으로 스크립트를 작성하고, 장면별로 스토리보드를 나누며, 각 샷에 대한 이미지를 생성하고, 카메라 움직임을 계획한 뒤 최종적으로 프레임을 조립하여 영상을 만듭니다.

핵심 워크플로우

Prompt → Script rewrite → Storyboard generation → Image creation → Camera‑move planning → Video rendering → Finished video

각 단계는 비동기 Celery 작업으로 실행되며, UI에 실시간 진행 상황이 표시됩니다. 사용자는 언제든지 일시 중지, 재개 또는 재시도를 할 수 있습니다.

주요 기능

기능	설명
스마트 스크립트 재작성	주제나 개요를 받아 영상용 전체 스크립트를 생성합니다. 다양한 작문 스타일을 지원하며 기본 LLM(OpenAI, Claude 등)을 선택할 수 있습니다.
자동 스토리보드	스크립트를 장면으로 나누고, 시각적 설명과 내레이션을 작성하며, 이미지 생성을 위한 프롬프트 문자열을 만듭니다.
AI 이미지 생성	외부 이미지 생성 서비스(Stable Diffusion, DALL‑E, Midjourney 등)를 호출하여 각 스토리보드 패널에 맞는 고품질 이미지를 생성합니다.
카메라 움직임 계획	각 이미지에 대해 팬/줌/틸트 지침을 생성하여 최종 영상에 역동성을 부여합니다.
이미지-영상 렌더링	이미지와 모션 계획을 영상 생성 백엔드(Runway, Pika 등)로 전송하여 영상 클립을 생성합니다.
프로젝트 관리	여러 영상 프로젝트를 정리하고, 워크플로우 상태를 추적하며, 일시 중지/재시도 및 자막이 포함된 최종 영상 내보내기를 지원합니다.
프롬프트 라이브러리	변수(주제, 스타일, 길이)가 포함된 재사용 가능한 프롬프트 템플릿을 저장하고 버전을 관리합니다.
모델 구성	AI 제공업체의 API 키 추가, 단계별 모델 선택, 사용량/비용 통계 확인을 위한 중앙 집중식 UI를 제공합니다.

기술적 특징

백엔드 – Docker 컨테이너에서 실행되는 Django 애플리케이션.
작업 큐 – Celery 워커(gevent pool)가 장시간 실행되는 AI 호출을 처리.
캐시 / 메시징 – Redis를 Celery 브로커 및 결과 백엔드로 사용.
프론트엔드 – 별도의 컨테이너에서 제공되는 Vue.js 싱글 페이지 애플리케이션.
모듈식 파이프라인 – 각 처리 단계는 책임 연쇄 패턴(responsibility‑chain pattern)의 플러그인으로 구성되어 새로운 AI 서비스 추가가 용이함.
로드 밸런싱 및 내결함성 – 여러 모델 엔드포인트 간의 라운드 로빈, 랜덤, 가중치 기반 또는 최소 부하 라우팅을 지원하며 실패 시 자동 재시도.
배포 – 완전 컨테이너화; docker‑compose up -d 명령 하나로 Redis, Django 백엔드, Celery 워커, Vue 프론트엔드가 모두 실행됨.

시작하기

Docker와 Docker‑Compose를 설치합니다.
docker‑compose.yml을 생성합니다(README에 예제 제공).
docker compose up -d를 실행합니다.
docker‑compose exec backend python backend/manage.py createsuperuser로 관리자 계정을 생성합니다.
브라우저에서 http://localhost:3000에 접속하여 UI를 사용합니다.

라이선스

코드는 CC BY‑NC‑SA 4.0 라이선스로 배포됩니다(비상업적 용도로만 사용 가능; 상업적 이용은 저자로부터 별도의 라이선스를 받아야 함).

사용 대상

연락처 / 커뮤니티

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며, 추가적인 기능은 추론되지 않았습니다.