render-cartoon-music-video은(는) 무엇을 하나요?
config 파일로부터 애니메이션 뮤직비디오 광고를 조립합니다. 애니메이션 / 일러스트레이션 / 수공예 스타일의 스토리(스톱모션 펠트-앤-폼, 클레이메이션, 2D 툰, 컷아웃 등)에서 노래가 전체 스크립트가 되고 하나의 반복되는 애니메이션 캐릭터가 모든 장면을 이끌며, 드롭에서 클라이맥스 대사와 함께 BAR 단위로 컷됩니다. 이 기능은 무료 결정론적 조립 — BAR 단위 컷, 하드 연결, 로고 버그 + 자막 입히기, 단색 엔드 카드 추가입니다.
scripts/config.example.json은 실제 예시(Coinbase "Bet on anything", ~55초 1080×1920 9:16, 16개 본문 마디 + 3초 엔드 카드 — 펠트 룩, 캐릭터, 스토리 및 노래는 데모의 선택이며 기본값이 아닙니다)입니다. scripts/PIPELINE.md는 각 config 블록을 해당 소스 단계에 매핑하며, scripts/README.md는 무료 조립 절차를 문서화합니다.
선택 사항
창의적인 결정은 호출자의 몫입니다(비디오 포맷 레시피가 사용자에게 묻습니다). 이 조립 단계는 절대 선택하지 않습니다. 데모의 가치는 단지 예시일 뿐입니다:
- 아트 스타일 / 룩 팩 (펠트 스톱모션, 클레이메이션, 2D 툰, 컷아웃…) — 데모: 펠트-앤-폼 디오라마.
- 캐릭터 — 하나의 반복되는 애니메이션 인물 — 데모: 브랜드 파란색 저지를 입은 중성적인 펠트 인물.
- 스토리 아크 — 데모: 약자가 성공하는 이야기.
- 노래 스타일 + 리드 보컬 — 데모: 신나는 댄스 팝 / EDM-트랩, 남성 하프-랩 리드.
실행
이것은 무료 결정론적 조립 단계입니다 — 비용이 들지 않습니다. 유료 입력은 별도의 기능입니다: 노래 (create-music-elevenlabs, 또는 사용자 제공 mp3 + Whisper 단어 타이밍)를 리브로사로 비트 추적하여 BAR 그리드가 타임라인을 설정하게 함; 하나의 고정된 반복 캐릭터 + 각 마디당 하나의 키프레임(하나의 룩 팩 내에서) (create-image-fal, Nano Banana); 그리고 각 마디당 하나의 Seedance i2v 클립 (create-video-fal). 노래 + word-timestamps.json + bars.json + 각 마디당 하나의 클립 + 브랜드 워드마크 SVG가 주어지면, render-cartoon-music-video는 각 클립을 해당 BAR 구간으로 자르고, BAR에서 하드 연결하며, 로고 버그 + 자막을 입히고, 단색 엔드 카드를 추가한 후, 그 위에 노래를 믹싱하여 마스터를 만듭니다. 재컷은 기존 노래/키프레임/클립을 재사용하며 비용은 $0입니다.
계약 (무료 조립)
- 노래가 내러티브를 전달합니다 — 별도의 VO 없음. 생성/제공된 트랙이 그 자체로 배경음입니다(덕킹할 VO 없음). 음성 내레이션이나 두 번째 배경음을 추가하지 마십시오.
- 타임라인을 전달된 노래의 BAR 그리드를 기준으로 계획하십시오. 리브로사로 노래를 비트 추적(4/4 가정)하고; 한 마디 = 한 장면(기본값). 모든 타블로 창을 BAR 경계에 맞추십시오 — 미리 계획된 그리드에 맞춰 노래를 자르지 마십시오.
- 자막은 노래의 단어 타이밍에서 가져오되, 고정된 가사에 맞게 다시 표기하십시오. Whisper는 외치는 억양("BETS" → "Hearts")을 잘못 인식합니다. 시간이 지정된 토큰을 고정된 가사 파일에 맞게 다시 표기하십시오(Whisper에 맞추기 위해 가사를 편집하지 마십시오). VEED-Whisper 스타일 흰색 굵은 산스체를 아래쪽 1/3(정렬 2,
margin_v는 왼쪽 아래 로고 버그 위), 큐당 약 4-5단어, 배경 알림 핀 없음; 자막은 엔드 카드 경계에서 중단됩니다. 절대 프레임 중간에 위치하지 않음 — 캐릭터를 가리기 때문(2026-07 고정). 호스트 ffmpeg에 libass가 없으면, 큐를 시간이 지정된 PIL PNG 오버레이(ffmpegoverlay=…:enable='between(t,st,en)')로 동일한 아래쪽 위치에 렌더링하십시오. - 클라이맥스 대사를 드롭에 맞추십시오. 클라이맥스 타블로는 보상 대사가 서브베이스 드롭에 있도록 시간을 맞추십시오; 해당 대사를 강조하십시오.
- 지속적인 로고 버그, 엔드 카드에서는 숨김. 본문 마디 위에 흰색 브랜드 워드마크를 왼쪽 아래에 입히고(cairosvg → PIL, 실제 SVG에서), 엔드 카드에서는 숨기며 큰 워드마크가 지배적이게 하십시오.
- 엔드 카드는 cairosvg + PIL을 통해 실제 워드마크에서 생성 — 절대 AI로 브랜드 텍스트를 렌더링하지 마십시오. 단색 브랜드 컬러 카드 + 흰색 워드마크 + 부제목, 약 3초 동안 노래가 계속 재생되면서 유지(afade-out은 꼬리 부분에 적용 — 무음 꼬리 없음). 확산 모델은 워드마크를 왜곡합니다.
- FFmpeg 합성, 결정론적, 무료. 각 클립을 해당 BAR 구간으로 자르고, 하드 연결하며, 로고 버그 + 자막을 입히고, 엔드 카드를 추가한 후, 전체 비디오 위에 0.5초 afade 꼬리와 함께 노래를 믹싱하고,
loudnorm I=-14적용 → 1080×1920 h264+aac 마스터. 유료 호출, 키 없음. 호스트 ffmpeg에 libass/drawtext가 없으면, 자막과 로고 버그 모두 시간이 지정된 PIL PNG 오버레이(overlay=x:y:enable='between(t,st,en)')로 처리되며, ASS 번인이 아닙니다. - 장면별 QC, 마스터만 확인하지 마십시오 — 두 가지 실패 모드는 내용, 조립이 아닙니다. 상위 키프레임/i2v 단계는 (a) 캐릭터가 룩에서 벗어날 수 있고(데모에서 펠트 → 부드러운 3D "남자"로) (b) 손을 환각할 수 있습니다 — 손 매크로의 현실적인 손가락, "폰 탭" 장면의 가리키는 손가락, 또는 프레임 가장자리에서 슬라이딩해 들어오는 분리된 손. 둘 다 썸네일 크기에서는 숨습니다. 2fps 접촉 시트 + 각 마디별 얼굴 크롭 및 손 크롭(각 클립의 전체 지속 시간 동안)을 추출하여, 모든 마디가 하나의 선택된 룩(데모: 무광 펠트)과 하나의 캐릭터를 유지하며 인간/떠다니는 손이 없는지 확인하고, 게시 후 제공된 바이트를 다시 확인하십시오. 룩이 벗어난 마디는 해당 마디의 키프레임을 재생성해야 합니다(재컷 아님) — 레시피 STEP 3/6을 참조하십시오.