Communitygithub.com

CineStory Studio : 시네마틱 스토리 비디오 제작

소설 챕터나 내러티브 스크립트를 Gemini 멀티모달 이미지 생성, Gemini TTS 음성, HyperFrames GSAP 애니메이션을 활용한 시네마틱 스토리텔링 비디오로 제작합니다. 캐릭터 일관성, 유려한 카메라 컷, 자막/오디오 클러터 없이 몰입감을 제공합니다.

CineStory Studio : 시네마틱 스토리 비디오 제작란 무엇인가요?

이 스킬은 소설 챕터나 내러티브 스크립트를 고품질 시네마틱 스토리텔링 비디오로 변환하는 종단 간 제작 파이프라인을 제공합니다. 핵심 기능으로는 Gemini 2.5 Flash 이미지 모델을 사용한 멀티모달 이미지 생성에서 캐릭터 참조 이미지를 바이트 단위로 전달하여 캐릭터 일관성을 유지하는 '참조 이미지 앵커링' 기법, Gemini 3.8 Flash TTS를 통한 순수 스튜디오 음성 내레이션 생성, 그리고 HyperFrames AI (GSAP 기반)를 이용한 다중 샷 카메라 연출 및 키네틱 애니메이션 조립이 포함됩니다. 이 스킬은 Claude Code와 같은 AI 에이전트 환경에서 사용하도록 설계되었으며, 사용자가 이야기를 영상으로 만들거나, HyperFrames로 시네마틱 애니메이션을 만들거나, 오디오-비주얼 스토리텔링 콘텐츠를 제작해 달라고 요청할 때 자동으로 활성화됩니다. 제작 과정은 씬 분할 및 스토리보드 작성, 캐릭터 바이블 및 참조 시트 생성, 멀티모달 이미지 생성, 순수 음성 내레이션, HyperFrames 조립, 최종 검증 및 렌더링의 6단계로 구성됩니다. 특히 AI 에이전트에게 사용자 요청에 따라 자막과 배경 음악 없는 깔끔한 시네마틱 경험을 제공하도록 지시하며, .env 파일 보안을 강조하고 절대 읽거나 편집하지 못하도록 합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nine-programmer/CineStory-Studio/tree/HEAD/.agents/skills/cinematic-story-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

시네마틱 스토리 비디오 제작 스킬

이 스킬은 소설 챕터나 내러티브 스크립트를 고품질 시네마틱 스토리텔링 비디오로 종단 간 제작하는 방법을 안내합니다. 멀티모달 이미지 생성과 캐릭터 참조 앵커링, Gemini TTS를 통한 순수 스튜디오 음성, HyperFrames AI(GSAP)를 사용한 유려한 멀티 샷 카메라 연출을 결합합니다.


핵심 철학 및 제작 기준

  1. 엄격한 캐릭터 일관성: 모든 캐릭터는 참조 컨셉 시트를 사용하여 시각적으로 고정되어야 합니다. 블라인드 텍스트 프롬프트만으로 스토리 씬을 생성하지 마십시오. 항상 캐릭터 참조 이미지 바이트를 전달하고 시각적 DNA(얼굴 구조, 헤어스타일, 의상)를 강제하십시오.
  2. 순수 스튜디오 음성 (Gemini TTS): 내레이터 음성은 반드시 gemini-3.8-flash-tts를 사용하여 생성해야 합니다. 절대로 시스템 프롬프트, 톤 지시사항 또는 메타데이터를 콘텐츠 프롬프트에 넣지 마십시오. 그렇지 않으면 TTS 모델이 지시문을 그대로 읽어버립니다. 순수한 스토리 내레이션 텍스트만 전달하십시오.
  3. 인공 오디오 클러터 금지: 사용자가 명시적으로 요청하지 않는 한 절차적/인공 SFX 및 일반 배경 음악을 사용하지 마십시오. 깨끗하고 명료한 음성 내레이션이 오디오북과 영화가 결합된 몰입감을 제공합니다.
  4. 자막 금지: 특별히 요청하지 않는 한 시네마틱 캔버스에 자막을 입히거나 오버레이하지 마십시오. 2.39:1 아나모픽 레터박스로 화면을 깔끔하게 유지하여 시각적 효과를 극대화하십시오.
  5. 다이내믹 시네마틱 샷: 단락당 단일 정적 샷을 피하십시오. 강도 높은 액션 장면의 경우 비트를 빠른 멀티 샷 컷으로 나누십시오(예: 컷 1: 극단적 디테일/반응, 컷 2: 임팩트/와이드, 컷 3: 클로즈업 감정).
  6. 엄격한 보안 (.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단계: 스토리 분할 및 스토리보드 구성

  1. 대상 소설 챕터 또는 스토리 텍스트를 읽습니다 (예: chapter_01.md).
  2. 챕터를 8-12개의 개별적인 시네마틱 비트/씬으로 나눕니다.
  3. 각 씬에 대해 다음을 지정합니다:
    • scene_id: 예: scene_01, scene_02 등
    • title: 짧은 설명 제목 (태국어/영어)
    • narration: 해당 씬의 정확하고 순수한 태국어 내레이션 텍스트
    • visual_prompt: 상세한 시네마틱 프롬프트 (16:9, 조명, 카메라 앵글, 분위기)
    • characters_present: 캐릭터 키 목록 (예: ["prima", "tawan"])
  4. 분할 결과를 video_project/storyboard.json에 저장합니다.

2단계: 캐릭터 바이블 및 참조 앵커링

  1. character_references/character_bible.md를 확인하여 기존 캐릭터가 정의되어 있는지 확인합니다.
  2. 새 캐릭터를 도입하는 경우 먼저 전용 캐릭터 참조 시트를 생성합니다:
    • 형식: 중립적인 시네마틱 스튜디오 배경에 여러 각도(클로즈업 초상화, 3/4 뷰, 전신)를 보여주는 16:9 와이드스크린 컨셉 시트
    • character_references/<character_key>_reference_sheet.png에 저장합니다.
    • character_references/character_bible.md에 정확한 시각적 DNA(나이, 얼굴 특징, 헤어스타일, 의복 스타일, 독특한 특성)를 문서화합니다.

자세한 참조 프롬프트 템플릿은 캐릭터 일관성 가이드를 참조하십시오.


3단계: 멀티모달 이미지 생성

  1. Google GenAI SDK를 통해 gemini-2.5-flash-image를 사용합니다.
  2. 기존 캐릭터가 등장하는 씬의 경우:
    • 캐릭터 참조 시트를 바이너리 이미지 바이트로 로드합니다.
    • 멀티모달 요청에 텍스트 프롬프트와 함께 참조 이미지 파트를 제공합니다.
    • 모델에 명시적으로 지시합니다: "참조 이미지의 정확한 캐릭터를 사용하십시오 (, ): [Scene description]"
  3. 액션/드라마틱 씬의 경우:
    • 다중 샷 하위 컷을 생성합니다 (예: scene1_cut1_tire.png, scene1_cut2_impact.png, scene1_cut3_face.png).
  4. 이미지를 video_project/images/에 저장하고 HyperFrames 프로젝트 에셋(sample_hyperframe/assets/)에 복사합니다.

도우미 스크립트: scripts/generate_scene_images.py


4단계: 순수 스튜디오 음성 (Gemini TTS)

  1. gemini-3.8-flash-tts 모델을 사용합니다.
  2. 오디오 생성을 구성합니다:
    • response_modalities=["AUDIO"]
    • speech_config 설정 (사전 빌드된 음성 사용, 예: Puck 또는 Aoede)
  3. 중요: 정확한 스토리 내레이션 텍스트만 contents에 전달합니다.
    # 올바른 예:
    response = client.models.generate_content(
        model="gemini-3.8-flash-tts",
        contents=scene["narration"],  # 순수 텍스트만!
        config=types.GenerateContentConfig(response_modalities=["AUDIO"], speech_config=...)
    )
    
  4. FFmpeg를 사용하여 원시 출력 PCM/WAV를 깨끗한 44.1kHz MP3로 변환합니다.
  5. 오디오 파일을 video_project/audio/voice/에 저장하고 sample_hyperframe/assets/에 복사합니다.

도우미 스크립트: scripts/generate_gemini_tts.py


5단계: HyperFrames 조립 및 시네마틱 모션

  1. ffprobe를 사용하여 각 씬 음성 파일의 길이를 측정합니다.
  2. 씬 시작 시간과 길이를 계산합니다:
    • scene_duration = voice_duration + 0.6s (0.2초 프리롤 + 0.4초 여유)
  3. 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]
  4. 정확한 총 재생 시간으로 sample_hyperframe/hyperframes.json을 업데이트합니다:
    { "duration": 177.6, "fps": 30, "width": 1920, "height": 1080 }
    

도우미 스크립트: scripts/build_hyperframes_project.py 상세 애니메이션 가이드: HyperFrames 모션 가이드


6단계: 검증 및 렌더링

  1. 린트 검사:
    cd sample_hyperframe
    npx hyperframes lint
    
    0 에러, 0 경고여야 합니다.
  2. 전체 영화 렌더링:
    npx hyperframes render --output ../video_project/output/<chapter_name>_full_movie.mp4
    
  3. 품질 검증:
    • 파일이 존재하고 크기가 합리적인지 확인합니다 (~3분 Full HD 기준 150-250 MB).
    • 오디오-비디오 동기화 및 블랙 프레임, 오디오 드롭아웃이 없는지 확인합니다.

관련 스킬