Invokard Studio Local — 사용자 자료에서 MP4까지
사용자는 작은 Python 파일(reel.py)을 작성하여 리얼을 설명합니다: 어떤 사진이나 클립이 언제 화면에 나타나는지, 어떤 레이어(헤드라인, 칩, 목록 항목, 차트, 전환 효과, 엔드 카드)가 위에 오버레이되는지, 어떤 음성 파일이 언제 시작되는지, 음악과 효과가 어디에 배치되는지 등을 정의합니다. 엔진(scripts/reelkit.py)은 Pillow로 모든 프레임을 구성하고, ffmpeg로 파이프하여 전달한 후 오디오를 믹싱합니다. 비디오 편집기에서 편집되는 것은 없습니다: 모든 텍스트, 상자 및 애니메이션은 엔진에서 제공되므로 선명하고, 브랜드에 맞으며 정확한 타이밍을 가집니다.
두 번째 엔진은 **그리기(draws)**를 수행합니다: animation/은 이미 머신에 설치된 Chrome 또는 Edge(헤드리스)에서 React 컴포넌트를 프레임별로 렌더링하고 ffmpeg로 인코딩합니다. 촬영된 영상보다는 디자인된 콘텐츠(운동 타이포그래피, 애니메이션 광고, 성장하는 차트, 3D 제품, 물리, 파티클, 제품 사진을 광고로 변환)에 사용하세요. 출력은 MP4(또는 투명 프레임)이며, 몽타주에서 일반 클립이나 레이어처럼 사용되므로 하나의 리얼에 두 가지 모두 포함될 수 있습니다(§ 5).
모든 것은 이 컴퓨터에서 실행됩니다. 이 스킬은 작업 중에 업로드, 다운로드 또는 서비스를 호출하지 않습니다: 폰트는 번들로 제공되고, 음향 효과는 번들로 제공되며, 미디어는 사용자의 것입니다. 이 파일 전체를 읽은 다음, 현재 단계가 가리키는 참조 문서를 읽으세요. 플러그인 폴더의 examples/first-reel/reel.py 및 examples/animated-reel/reel.py는 외부 미디어 없이 완전한 리얼을 렌더링합니다: 기계가 렌더링할 수 있는지 확인하는 가장 빠른 방법입니다.
0. 기계 확인 (30초)
python <skill>/scripts/media.py doctor # python, ffmpeg, 패키지, 폰트, 포맷 확인
ffmpeg -version && ffprobe -version
ffmpeg 누락은 즉시 중단: 사용자에게 설치 방법을 알려주세요(references/troubleshooting.md). Pillow 또는 numpy 누락: python -m pip install Pillow numpy (PyPI에서 한 번 다운로드합니다; 실행 전에 알려주세요).
1. 경로 선택
| 자료 종류 | 경로 | 참조 문서 |
|---|---|---|
| 사용자의 클립 또는 사진 | A · 푸티지: 콘택트 시트 → 세그먼트 선택 → 비트에 맞춰 자르기 → 전후 비교 → 엔드 카드 | references/footage.md |
| 사용자가 녹음할 수 있는 대본 | B · 음성: 사용자가 문장당 하나의 파일 녹음 → 단어별 자막 → 단어에 맞춰 자르기 | references/production.md |
| 광고, 제목, 차트, 자랑할 제품, 푸티지 없음 | C · 그리기: 애니메이션 프로젝트(React) → 키 프레임 정지 → 프레임 → 렌더링 | references/animation.md |
| 텍스트와 음악만 있음 | D · 화면 텍스트: 클라이언트 대본을 그려진 배경이나 사진 배경 위에 애니메이션 텍스트로, 비트에 맞춰 자르기 | references/production.md § 자막 |
경로는 혼합 가능: 푸티지 리얼은 사용자의 음성을 포함할 수 있습니다; 모든 리얼은 그려진 레이어, 그려진 차트 또는 그려진 엔드 카드를 포함할 수 있습니다(§ 5).
2. 워크플로우
- 작업 폴더 —
python scripts/new_reel.py <folder> --brand studio|lime|forest|mono --title "…" [--format 16:9|1:1].img/,vid/,frames/,vo/,music/,sfx/,ref/,out/,review/폴더와 템플릿에서reel.py를 생성합니다; 형식(요청 없으면 9:16)은 상단에rk.set_format()으로 설정됩니다. 브랜드:pieces.Brand.from_logo('ref/logo.png')가 실제 색상을 측정합니다; 색상을 출력하고 로고 파일을 먼저 확인하세요(폴더에는 오해의 소지가 있는 파일 이름이 가득합니다). - 대본 — 35-45초 분량에 85-100 단어. 첫 문장에서 후크(hook), 문장당 하나의 아이디어, 후크를 반향하는 결말. 사용자 자료에 있는 내용만 주장하세요: 새로운 수치, 새로운 약속 없음. 사용자가 대본을 제공했다면 그대로 사용하세요.
- 음성 — 사용자가 녹음하며, 문장당 하나의 파일(
vo/v01.m4a,v02…; mp3, wav, m4a 모두 작동): 휴대폰 음성 메모로 충분합니다. 요청 방법과 녹음되지 않은 동안 수행할 작업은references/production.md§ 음성에 있습니다. 그런 다음python scripts/media.py voice <folder>: 지속 시간과 유성 구간; 모든 타이밍과 컷은 이로부터 파생됩니다. 음성 없음(화면 대본, 음악만)? 4단계로 건너뛰세요. - 이미지 및 클립 — 사용자의 사진은
img/, 클립은vid/에 있습니다.python scripts/media.py sheet-img <folder>와sheet-footage는 한 장의 시트에 보여줍니다: 선택하기 전에 꼭 보세요. 그려진 배경, 카드 및 차트는 pieces 또는 애니메이션 엔진에서 가져옵니다. - 먼저 정지 이미지로 편집 —
pieces.source(name, 'img/x.png')를 사용하여reel.py를 작성하고python reel.py --preview를 실행하세요.review/preview.jpg를 확인하세요. 렌더링 전에 리듬, 프레이밍 및 레이어를 수정하세요. 이 단계가 리얼이 만들어지는 곳입니다; 서두르지 마세요. - 클립 —
media.py extract는 리얼이 사용하는 실제 푸티지의 세그먼트를frames/<name>/으로 자릅니다;media.py frames는 전체 클립을 변환합니다. 모션 시트를 확인하세요(media.py sheet-motion <folder>). - 음악 및 효과 — 사용자 자신의 트랙을
music/에 넣습니다(사용권이 있는 것), 또는 없음. 엔진은 첫 번째 온셋(onset)부터 트림하고 음성 아래에서 덕킹(ducking)합니다. 효과는 번들로 제공됩니다:pieces.sfx('whoosh'|'pop'|'shimmer'|'chime'|'typing'|'shutter'|'coaster'|'fridge'). 음성이 없을 때는 비트에 맞춰 자르기:media.py beats→references/footage.md. - 렌더링 및 검증 —
python reel.py, 그런 다음python scripts/media.py verify out/reel.mp4: 사양, 음량(목표 −14 LUFS) 및 최종 MP4에서 가져온 콘택트 시트를 확인합니다. 그 시트를 확인하세요. 그런 다음 중요한 순간(자막 변경, 전환 효과, 엔드 카드)에 2-3개의 전체 프레임(media.py frame out/reel.mp4 <t>)을 확인하세요. - 전달 —
out/reel.mp4+out/cover.jpg(reel.cover(t, 'out/cover.jpg')) + 캡션 텍스트와 해시태그를.md파일로 + 소스(reel.py,img/,vo/,music/,ref/;frames/는 제외). 아무것도 게시하지 마세요: 사용자가 합니다. 확인할 수 없는 사항을 보고하세요(믹스를 들을 수 없습니다: 그렇게 말하고 음량 수치를 제공하세요).
3. 실제 실수로부터 얻은 규칙
- 모든 시트를 확인하세요.
imgs.jpg,motion.jpg,preview.jpg,verify시트. 확인되지 않은 렌더링은 전달하지 않습니다. - 로고. 파일 이름을 절대 신뢰하지 마세요. 열어보세요. 작으면 측정된 색상으로 텍스트 워드마크를 다시 만드세요.
- 타사 브랜드. 사용자의 것이 아닌 로고나 아이덴티티(예: 사용자가 판매하는 제품의 제조사)를 절대 추가하지 마세요. 브랜드는 사용자 자신의 푸티지에 이미 포함되어 있으면 나타날 수 있습니다; 절대 추가되지 않습니다.
- 컷은 음성에서 파생되며, 절대 시각적으로 판단하지 마세요:
caps.word_time(key, i)및media.py voice의 구간(spans). - 짧은 클립. 클립 속도를
speed=0.8미만으로 낮추지 마세요(24fps 소스에서 떨림 발생); 길게 하려면 같은 클립의 한 프레임으로Still을 앞에 배치하고 줌을 일치시키세요. - 안전 영역. Instagram은 상단 약 220px, 하단 약 360px을 덮습니다. 헤드라인과 칩은 y=230과 y=520 사이; 자막은 y≈1440; 중요한 것은 y≈1560 아래에 두지 마세요. 최소 텍스트 크기 30px(보조 칩 36-44, 헤드라인 70+). 16:9 및 1:1(높이 1080px): 헤드라인은 y≈110부터, 자막은 y≈880, 중요한 것은 y≈1000 아래에 두지 마세요. Pieces는
rk.LAYOUT에서 이러한 기본값을 사용합니다; 위치를 숫자로 쓸 때는 의도가 있을 때만 사용하고, 9:16 리얼에서 복사하지 마세요. - 형식.
rk.set_format('16:9')(또는REELKIT_FORMAT=16:9)를from reelkit import W, H및 모든 소스나 레이어보다 먼저 작성하세요. 형식에 맞게 클립을 추출하세요:media.py frames <work> --format 16:9. - 밝은 배경의 자막은 첫 번째 레이어로
pieces.bottom_gradient(brand)가 필요합니다. - 사용자 클립의 음악은 재사용할 수 없습니다. 실제 소리(세탁기, 엔진)는
media.py sound로 푸티지에서 잘라낼 수 있습니다; 클립 배경에서 재생되는 노래는 사용 허가가 아닙니다.
4. 한 화면의 엔진 (전체 참조: references/api.md)
import reelkit as rk; rk.set_format('9:16') # '16:9' / '1:1': 먼저, W와 H는 import 시 복사됨
from reelkit import W, H, Reel, Captions, Still, Clip, Func, blit, text_img, pill, lerp, clamp01, eo, eio, eback
import pieces as pz; from pieces import source, sfx
rk.set_base(folder); B = pz.BRANDS['lime'].activate() # 또는 pz.Brand.from_logo('ref/logo.png').activate()
reel = Reel('name'); caps = Captions(size=70, y=1440, maxw=920); reel.caps = caps # 16:9 / 1:1: Captions(size=62)
t_end = reel.vo('vo/v01.m4a', 0.30) # 문장이 끝나는 위치 반환
caps.line('v01', 'Sentence with *key* *words*, / next block.', 'vo/v01.m4a', 0.30) # *hl* · / break · shown|spoken
t = caps.word_time('v01', 2) # 세 번째 단어가 발화되는 순간 → 여기서 컷
reel.shot(0.0, t, source('hero', 'img/hero.jpg', z=(1.0, 1.06), c=(.5, .45)))
reel.shot(t, 5.0, Clip('hero', speed=1.0, start=0.25, z=(1.14, 1.24))) # frames/hero/는 media.py extract에서 생성
GRAD = pz.bottom_gradient(B); reel.ov(0.0, 5.0, lambda c, tl, dur, T: c.alpha_composite(GRAD)) # 레이어: (canvas, tl, dur, t)
reel.ov(0.0, t, pz.headline(B, 'KICKER', 'Hook line', 'KEY PHRASE'))
reel.ov(t, 5.0, pz.list_item(B, 1, 3, 'ITEM', 'One-line benefit'))
reel.ov(0.0, 4.0, pz.text_layer('Client script *highlighted*')) # 음성 없는 화면 텍스트
SITE = pz.browser_frame('img/site.png', 1000, url='site.com') # 이미지를 한 번 빌드, 레이어 외부에서
reel.ov(t, 5.0, lambda c, tl, dur, T: pz.appear(c, SITE, W / 2, H * .4, tl, 0)) # 스크린샷 팝인 (phone_frame도 가능)
reel.shot(5.0, 8.0, pz.wipe_scene(before_src, after_src, B, hold=1.0)) # 전후 비교
reel.shot(8.0, 11.0, pz.outro_save(B, 'img/hero.jpg', 'ref/logo.png', cta='Book a call · site.com'))
reel.sfx(sfx('whoosh'), t - 0.12, 0.32); reel.sfx(sfx('chime'), 8.3, 0.30)
reel.preview([0.5, 2.0, 4.5, 6.0, 9.0], 'review/preview.jpg', cols=5, scale=0.22)
reel.render('out/reel.mp4', 11.0, music='music/base.mp3', music_gain=0.24); reel.cover(1.2, 'out/cover.jpg')
레이어는 blit으로 캔버스에 RGBA를 그리는 함수 f(canvas, t_local, duration, t_global)입니다. 소스는 .frame(t_local, duration) 메서드를 가진 객체로, 캔버스 크기(W x H)의 RGB 이미지를 반환합니다: Still, Clip, Func(f), 그리고 pieces의 장면들(wipe_scene, outro_save, outro_fan, blur_in). 이징: eo(out), eio(in-out), eback(pop). 이미지(그라디언트, 카드, 프레임)는 레이어 함수 외부에서 한 번 빌드하세요; 텍스트와 알약(pills)은 캐시됩니다.
5. 그리기 애니메이션 (전체 참조: references/animation.md)
한 번 설정: Node.js 18+, 그런 다음 <skill>/animation 내에서 npm install (npm에서 엔진 패키지를 한 번 다운로드합니다; 실행 전에 알려주세요) 및 node <skill>/animation/cli.mjs doctor 실행. 프로젝트는 package.json, src/index.jsx(registerRoot + 비디오당 하나의 <Composition>) 및 해당 파일을 위한 public/ 폴더로 구성된 폴더입니다. 컴포넌트는 'invokard-studio'에서 가져옵니다: useCurrentFrame, spring, interpolate, Sequence, Img + staticFile, OffthreadVideo, 3D는 'invokard-studio/three'에서, 폰트는 'invokard-studio/google-fonts/<Family>'에서 가져옵니다. — 번들된 15개 패밀리만 해당: Inter, Outfit, Figtree, Poppins, Montserrat, Space Grotesk, Barlow, Barlow Condensed, Oswald, Anton, Bebas Neue, Playfair Display, Fraunces, Shrikhand, Caveat. 다른 서체: 사용자가 파일을 public/에 넣고 @font-face로 선언합니다.
node <skill>/animation/cli.mjs still src/index.jsx Ad out/ad.png --frame 120 # 1. 키 프레임 디자인
node <skill>/animation/cli.mjs frames src/index.jsx Ad out/ad --frames 0,34,68,102,136,170,204,239 # 2. 모션 확인
node <skill>/animation/cli.mjs render src/index.jsx Ad out/ad.mp4 --props data.json # 3. 비디오 (모든 프레임)
모든 프레임은 숫자로부터 계산됩니다(Math.random 없음, 시계 없음, CSS 애니메이션 없음): 프레임은 여러 탭에서 순서 없이 그려집니다. 리얼에서처럼 렌더링하는 모든 정지 이미지와 프레임 시트를 확인하세요. 리얼 내에서:
import animation as an # scripts/animation.py
an.render('anim/src/index.jsx', 'Title', rk.P('anim/title'), transparent=True) # 알파가 있는 PNG 프레임
reel.ov(t0, t1, an.layer(rk.P('anim/title'))) # 몽타주 위에 그려진 레이어
reel.shot(t2, t3, an.clip('anim/src/index.jsx', 'EndCard', 'endcard')) # 그려진 샷, 클립처럼 컷
플러그인 폴더의 examples/animated-reel/은 두 가지를 모두 수행하는 완전한 리얼이며, 외부 미디어가 없습니다.
6. 전달물 체크리스트
-
out/reel.mp4는 1080x1920(또는 요청된 1920x1080 / 1080x1080), 30fps, H.264 + AAC, −14 LUFS ± 1, 피크 ≤ −1 dBFS (media.py verify) - 검증 시트와 2-3개의 전체 프레임을 확인했으며; 자막이 y≈1560 아래나 얼굴/제품 위에 있지 않음
- 화면의 모든 주장은 사용자 자료에 있음; 브랜드 색상은 추측이 아닌 측정된 값
-
out/cover.jpg는 피드의 4:5 중앙 크롭 내에서 읽기 쉬움 -
frames/없이 소스 전달; 아무것도 게시하지 않음
7. 이 빌드가 하지 않는 것
AI를 사용하여 이미지, 비디오 클립, 음성, 음악 또는 3D 모델을 생성하지 않으며, 어떤 온라인 서비스도 호출하지 않습니다. 요청에 이러한 것 중 하나가 필요하면 계획에 명확히 명시하세요: 비디오는 사용자 자신의 사진, 클립 및 녹음, 그리기 애니메이션(제목, 차트, 3D 제품, 도형으로 만든 일러스트레이션) 또는 사용자가 원하는 곳에서 가져온 파일로 지금 만들 수 있습니다. 특정 제품이나 서비스를 추천하지 마세요.
참조 문서
references/production.md— 사용자 음성, 자막, 안전 영역, 오디오, 브랜드.references/footage.md— 사용자 클립의 리얼: 콘택트 시트, 추출, 비트 그리드, 음악 이어붙이기, 전환 효과, 엔드 카드.references/animation.md— 애니메이션 엔진: 프로젝트, 명령어, API, 번들 폰트, 몽타주 + 애니메이션, 문제 해결.references/api.md—reelkit.py,pieces.py및media.py의 모든 함수와 인수, 형식별 기본 위치.references/troubleshooting.md— ffmpeg, 폰트, Windows 콘솔, 긴 렌더링.