cinematic-storyboard-to-video

name

cinematic-storyboard-to-video

description

영화/뮤직비디오급 스토리보드(分镜)를 이미지→영상 파이프라인으로 만드는 오케스트레이터. GPT Image 2로 시네마틱 스토리보드 그리드(또는 단일 프롬프트 풀-스토리)를 생성 → 샷별 프레임으로 분할 → 각 샷을 Seedance 2.0 image-to-video 프롬프트로 영상화 → 클립 합성. Use when "MV 스토리보드", "분경/分镜", "storyboard to video", "K-pop MV 생성", "영화 스토리보드 영상화", "GPT Image 2 스토리보드", "Seedance MV", "콜티 영상", "cinematic storyboard", "single-prompt film story". Do NOT use for 단일 이미지 생성만 (use gpt-image-2), Seedance 프롬프트 문법만 (use seedance2-skill / seedance-prompt-engineer), 소재 클립 편집만 (use video-producer).

Cinematic Storyboard → Video (MV / Film)

두 개의 검증된 스킬을 얇게 지휘한다: gpt-image-2(실제 이미지 생성)와 seedance2-skill (Seedance 2.0 프롬프트 작성). 이 스킬은 능력을 재구현하지 않고 분镜 프롬프트 패턴 + 그리드→샷 분할 + 파이프라인 계약만 소유한다([[thin-harness-fat-skills]]).

출처: cellinlab(@cellinlab, GPT Image 2→Seedance 2.0→Rita로 K-pop MV) + Olivio Sarikas (@OlivioSarikas, GPT Image 2 단일 프롬프트 풀-필름 스토리, 3840x2160). 2026-07 distill.

⛔ 핵심 gotcha (이걸 몰라서 실패한다)

스토리보드 그리드 프롬프트를 그대로 비디오 모델에 던지면 영상이 안 나온다(cellinlab이 겪은 바로 그 문제). 비디오는 샷 단위 image-to-video(i2v) 로만 나온다 → 그리드를 반드시 개별 샷 프레임으로 분할한 뒤, 각 프레임을 1개 클립으로 영상화하고 합친다. 분할은 눈대중이 아니라 scripts/slice_grid.py(결정론 코드)가 소유한다.

4단계 파이프라인

Phase A — 스토리보드 이미지 생성 (gpt-image-2가 소유)

분镜 프롬프트를 짓는다(패턴은 references/storyboard-prompt-packs.md). 두 모드:

• 그리드형(K-pop MV 액션 시퀀스): 3x3/2x2 스토리보드를 한 장에. 캐릭터 일관성 + 컬러 그레이딩·피사계심도·모션블러 등 시네마틱 스펙 명시. 이 스토리보드 이미지가 Seedance의 "visual DNA" — 캐릭터·의상·배경·조명·색감을 고정하는 앵커(0xInk_ 개념). 크게 뽑을수록 샷 해상도 확보(GPT Image 2 = DALL-E 3 대비 ~4배 컴퓨팅).
• 장르 프리셋(게임 보스전·애니 레이싱·실사 단편·게임개발): references/genre-presets.md 참조.
• 단일 프롬프트 풀-스토리(Olivio 패턴): Thinking 모드로 다중 프레임 내러티브를 한 프롬프트에. 캐릭터 일관성 + 시퀀스 코히런스. 최대 8장 동시, 최대 2K(3840x2160까지).

uv run .claude/skills/gpt-image-2/scripts/generate_image.py \
  --prompt "<references/storyboard-prompt-packs.md의 분镜 템플릿으로 작성>" \
  --size 3840x2160 --output outputs/mv/{slug}/storyboard.png

게이트: 파일 존재 + 캐릭터/스타일 일관성 육안 확인 후 다음 단계. (OPENAI_API_KEY 필요.)

Phase B — 그리드를 샷 프레임으로 분할 (이 스킬이 소유, 결정론)

.venv/bin/python .claude/skills/cinematic-storyboard-to-video/scripts/slice_grid.py \
  outputs/mv/{slug}/storyboard.png --rows 3 --cols 3 --gutter 12 \
  --out-dir outputs/mv/{slug}/shots/

→ shot_01.png..shot_09.png(행 우선). 패널 테두리가 있으면 --gutter로 안쪽 트림. 단일 프롬프트 풀-스토리가 이미 개별 이미지 N장이면 이 단계 생략(분할 불요).

Phase C — 샷별 Seedance 2.0 i2v 프롬프트 (seedance2-skill이 소유)

각 shot_NN.png를 첫 프레임으로 하는 image-to-video 프롬프트를 작성한다. Seedance 2.0은 공개 API가 없다 → 프롬프트만 만들고 Rita(GamsGo) 플랫폼에서 사용자가 실행한다 (references/tools-and-platform.md). 샷당 4~15초, 네이티브 오디오 동기(대사/SFX/BGM), 최대 2K. i2v 프롬프트 템플릿: references/storyboard-prompt-packs.md §Seedance.

Phase D — 클립 합성 (video-producer / ffmpeg-toolkit가 소유)

Rita에서 받은 샷 클립들을 순서대로 합쳐 최종 MV/필름을 만든다. video-producer 라우터 또는 ffmpeg-toolkit로 concat(오디오 있으면 재인코딩 concat, per-clip -c copy 갭 주의 [[tts-generation]] §3와 동형). 최종 .mp4는 ffprobe로 검증.

실행 규칙

• 자동화 가능 단계 = A(이미지 생성)·B(분할)·D(합성). C(Seedance 영상화)는 API 부재로 프롬프트 산출 + Rita 수동 실행(정직하게 사용자에게 넘긴다, [[mcp-graceful-degradation]]).
• 산출 경로: outputs/mv/{slug}/ (storyboard.png, shots/, clips/, final.mp4).
• 생성한 최종 이미지·영상은 인터랙티브 세션이면 open으로 띄운다([[display-generated-images]]).
• 사용자가 툴 명시("gpt-image-2로만", "Seedance 프롬프트만") 시 이 오케스트레이터 우회, 해당 스킬 직접.

Dependencies (재사용 — 재발명 금지)

• gpt-image-2/scripts/generate_image.py — 스토리보드 이미지 생성 (실제 엔진, 최대 3840x2160)
• seedance2-skill / seedance-prompt-engineer — Seedance 2.0 i2v 프롬프트 문법
• video-producer / ffmpeg-toolkit — 클립 합성·검증
• scripts/slice_grid.py — 그리드→샷 분할 (이 스킬 소유)
• 상세: references/storyboard-prompt-packs.md, references/tools-and-platform.md