시네마틱 스토리 비디오 제작 스킬
이 스킬은 소설 챕터나 내러티브 스크립트를 고품질 시네마틱 스토리텔링 비디오로 종단 간 제작하는 방법을 안내합니다. 멀티모달 이미지 생성과 캐릭터 참조 앵커링, Gemini TTS를 통한 순수 스튜디오 음성, HyperFrames AI(GSAP)를 사용한 유려한 멀티 샷 카메라 연출을 결합합니다.
핵심 철학 및 제작 기준
- 엄격한 캐릭터 일관성: 모든 캐릭터는 참조 컨셉 시트를 사용하여 시각적으로 고정되어야 합니다. 블라인드 텍스트 프롬프트만으로 스토리 씬을 생성하지 마십시오. 항상 캐릭터 참조 이미지 바이트를 전달하고 시각적 DNA(얼굴 구조, 헤어스타일, 의상)를 강제하십시오.
- 순수 스튜디오 음성 (Gemini TTS): 내레이터 음성은 반드시
gemini-3.8-flash-tts를 사용하여 생성해야 합니다. 절대로 시스템 프롬프트, 톤 지시사항 또는 메타데이터를 콘텐츠 프롬프트에 넣지 마십시오. 그렇지 않으면 TTS 모델이 지시문을 그대로 읽어버립니다. 순수한 스토리 내레이션 텍스트만 전달하십시오. - 인공 오디오 클러터 금지: 사용자가 명시적으로 요청하지 않는 한 절차적/인공 SFX 및 일반 배경 음악을 사용하지 마십시오. 깨끗하고 명료한 음성 내레이션이 오디오북과 영화가 결합된 몰입감을 제공합니다.
- 자막 금지: 특별히 요청하지 않는 한 시네마틱 캔버스에 자막을 입히거나 오버레이하지 마십시오. 2.39:1 아나모픽 레터박스로 화면을 깔끔하게 유지하여 시각적 효과를 극대화하십시오.
- 다이내믹 시네마틱 샷: 단락당 단일 정적 샷을 피하십시오. 강도 높은 액션 장면의 경우 비트를 빠른 멀티 샷 컷으로 나누십시오(예: 컷 1: 극단적 디테일/반응, 컷 2: 임팩트/와이드, 컷 3: 클로즈업 감정).
- 엄격한 보안 (
.env):.env파일을 절대 읽거나,cat으로 출력하거나, 표시하거나, 편집하지 마십시오. 백엔드 스크립트는 환경 변수를 프로그래밍 방식으로 런타임 메모리에 로드합니다.
제작 파이프라인 (단계별)
flowchart TD
A["챕터 텍스트 (chapter_XX.md)"] --> B["1. 씬 분할 및 스토리보드"]
B --> C["2. 캐릭터 바이블 및 참조 시트"]
C --> D["3. 멀티모달 이미지 생성 (gemini-2.5-flash-image)"]
B --> E["4. 순수 스튜디오 음성 (gemini-3.8-flash-tts)"]
D --> F["5. HyperFrames 구성 및 GSAP 모션"]
E --> F
F --> G["6. 검증 (npx hyperframes lint)"]
G --> H["7. 최종 렌더링 (npx hyperframes render)"]
1단계: 스토리 분할 및 스토리보드 구성
- 대상 소설 챕터 또는 스토리 텍스트를 읽습니다 (예:
chapter_01.md). - 챕터를 8-12개의 개별적인 시네마틱 비트/씬으로 나눕니다.
- 각 씬에 대해 다음을 지정합니다:
scene_id: 예:scene_01,scene_02등title: 짧은 설명 제목 (태국어/영어)narration: 해당 씬의 정확하고 순수한 태국어 내레이션 텍스트visual_prompt: 상세한 시네마틱 프롬프트 (16:9, 조명, 카메라 앵글, 분위기)characters_present: 캐릭터 키 목록 (예:["prima", "tawan"])
- 분할 결과를
video_project/storyboard.json에 저장합니다.
2단계: 캐릭터 바이블 및 참조 앵커링
character_references/character_bible.md를 확인하여 기존 캐릭터가 정의되어 있는지 확인합니다.- 새 캐릭터를 도입하는 경우 먼저 전용 캐릭터 참조 시트를 생성합니다:
- 형식: 중립적인 시네마틱 스튜디오 배경에 여러 각도(클로즈업 초상화, 3/4 뷰, 전신)를 보여주는 16:9 와이드스크린 컨셉 시트
character_references/<character_key>_reference_sheet.png에 저장합니다.character_references/character_bible.md에 정확한 시각적 DNA(나이, 얼굴 특징, 헤어스타일, 의복 스타일, 독특한 특성)를 문서화합니다.
자세한 참조 프롬프트 템플릿은 캐릭터 일관성 가이드를 참조하십시오.
3단계: 멀티모달 이미지 생성
- Google GenAI SDK를 통해
gemini-2.5-flash-image를 사용합니다. - 기존 캐릭터가 등장하는 씬의 경우:
- 캐릭터 참조 시트를 바이너리 이미지 바이트로 로드합니다.
- 멀티모달 요청에 텍스트 프롬프트와 함께 참조 이미지 파트를 제공합니다.
- 모델에 명시적으로 지시합니다: "참조 이미지의 정확한 캐릭터를 사용하십시오 (, ): [Scene description]"
- 액션/드라마틱 씬의 경우:
- 다중 샷 하위 컷을 생성합니다 (예:
scene1_cut1_tire.png,scene1_cut2_impact.png,scene1_cut3_face.png).
- 다중 샷 하위 컷을 생성합니다 (예:
- 이미지를
video_project/images/에 저장하고 HyperFrames 프로젝트 에셋(sample_hyperframe/assets/)에 복사합니다.
도우미 스크립트: scripts/generate_scene_images.py
4단계: 순수 스튜디오 음성 (Gemini TTS)
gemini-3.8-flash-tts모델을 사용합니다.- 오디오 생성을 구성합니다:
response_modalities=["AUDIO"]speech_config설정 (사전 빌드된 음성 사용, 예:Puck또는Aoede)
- 중요: 정확한 스토리 내레이션 텍스트만
contents에 전달합니다.# 올바른 예: response = client.models.generate_content( model="gemini-3.8-flash-tts", contents=scene["narration"], # 순수 텍스트만! config=types.GenerateContentConfig(response_modalities=["AUDIO"], speech_config=...) ) - FFmpeg를 사용하여 원시 출력 PCM/WAV를 깨끗한 44.1kHz MP3로 변환합니다.
- 오디오 파일을
video_project/audio/voice/에 저장하고sample_hyperframe/assets/에 복사합니다.
도우미 스크립트: scripts/generate_gemini_tts.py
5단계: HyperFrames 조립 및 시네마틱 모션
ffprobe를 사용하여 각 씬 음성 파일의 길이를 측정합니다.- 씬 시작 시간과 길이를 계산합니다:
scene_duration = voice_duration + 0.6s(0.2초 프리롤 + 0.4초 여유)
sample_hyperframe/index.html을 생성합니다:- 시네마틱 2.39:1 와이드스크린 레터박스 오버레이 (
.letterbox-top,.letterbox-bottom) - 자막이 없는 순수 이미지 컨테이너
- 정확한 타임스탬프에 예약된 네이티브
<audio>요소 (tl.call(() => audio.play(), ..., voice_start)) - GSAP 타임라인 애니메이션:
- 액션 비트에 대한 멀티 샷 컷 (화이트 플래시 전환과 함께 표시 전환)
- 슬로우 Ken Burns 푸시인/팬 (
scale: 1.0 -> 1.08-1.12) - 씬 간 부드러운 크로스페이드/컷
- 타임라인 등록:
window.__timelines = [tl]
- 시네마틱 2.39:1 와이드스크린 레터박스 오버레이 (
- 정확한 총 재생 시간으로
sample_hyperframe/hyperframes.json을 업데이트합니다:{ "duration": 177.6, "fps": 30, "width": 1920, "height": 1080 }
도우미 스크립트: scripts/build_hyperframes_project.py
상세 애니메이션 가이드: HyperFrames 모션 가이드
6단계: 검증 및 렌더링
- 린트 검사:
0 에러, 0 경고여야 합니다.cd sample_hyperframe npx hyperframes lint - 전체 영화 렌더링:
npx hyperframes render --output ../video_project/output/<chapter_name>_full_movie.mp4 - 품질 검증:
- 파일이 존재하고 크기가 합리적인지 확인합니다 (~3분 Full HD 기준 150-250 MB).
- 오디오-비디오 동기화 및 블랙 프레임, 오디오 드롭아웃이 없는지 확인합니다.