Invokard Studio — 아이디어에서 MP4까지
작은 Python 파일(reel.py)을 작성하여 릴을 설명합니다: 언제 어떤 이미지나 클립이 화면에 표시되는지, 어떤 레이어(헤드라인, 칩, 목록 항목, 차트, 전환, 엔드 카드)가 그 위에 나타나는지, 어떤 음성 파일이 언제 시작되는지, 음악과 효과음이 어디에 들어가는지. 엔진(scripts/reelkit.py)은 Pillow로 모든 프레임을 구성하고 ffmpeg로 파이프하여 오디오를 믹싱합니다. 비디오 편집기에서 아무것도 편집하지 않고 AI 이미지 모델로 아무것도 그리지 않습니다: 모든 글자, 상자 및 애니메이션은 엔진에서 생성되므로 선명하고 브랜드에 일치하며 정확한 타이밍을 갖습니다.
두 번째 엔진은 그립니다: animation/은 React 컴포넌트를 헤드리스 브라우저(이미 설치된 Chrome 또는 Edge)에서 프레임 단위로 렌더링하고 ffmpeg로 인코딩합니다. 디자인된 것을 편집된 것보다는 그리기 위해 사용하십시오: 운동 타이포그래피, 애니메이션 광고, 성장 차트, 3D 제품, 물리 효과, 파티클, 제품 사진을 광고로 변환. 출력은 MP4(또는 투명 프레임)이며 몽타주에서 클립이나 레이어처럼 사용되므로 하나의 릴에 두 가지를 모두 사용할 수 있습니다(§ 5).
이 파일을 전체 읽으십시오. 그런 다음 현재 단계가 가리키는 참조를 읽으십시오. reel.py를 작성하기 전에 assets/examples/에 있는 스크립트 중 하나를 읽으십시오(실제로 전달된 릴; 미디어와 미리보기는 리포지토리의 examples/에 있습니다). 리포지토리에서 python examples/first-reel/reel.py를 실행하면 미디어 없이 완전한 릴이 렌더링됩니다: 머신이 렌더링할 수 있는 가장 빠른 확인이며, 16:9도 보여주는 짧은 reel.py입니다.
0. 머신 확인 (30초)
python <skill>/scripts/media.py doctor # python, ffmpeg, 패키지, 폰트, 형식, 키 (이름만)
python <skill>/scripts/media.py fonts # 이모지 폰트가 없으면 다운로드
ffmpeg -version && ffprobe -version
ffmpeg가 없으면 하드 스톱입니다: 사용자에게 설치 방법을 알려주십시오(references/troubleshooting.md 참조). API 키가 없어도 됩니다: 엔진은 제공자 없이 로컬 미디어를 렌더링합니다. 사용자에게 채팅에 키를 붙여넣도록 요청하지 마십시오; .env.example을 가리키십시오.
1. 경로 선택
| 자료가… | 경로 | 참조 |
|---|---|---|
| 아직 없음: 주제, 기사, 캐러셀 | A · 생성됨: 스크립트 → 음성(문장당 하나의 파일) → AI 일러스트레이션 → 클립 → 자막 | references/production.md |
| 클라이언트의 클립 또는 사진 | B · 푸티지: 콘택트 시트 → 세그먼트 선택 → 비트에 맞춰 컷 → 전/후 → 엔드 카드 | references/footage.md |
| 녹음된 내레이션, 인터뷰, 노래 | C · 자체 오디오: align.py가 단어 타이밍 제공 → 단어에서 자막 | references/production.md § 자막 |
| 광고, 제목, 차트, 자랑할 제품, 푸티지 불필요 | D · 그려진: 애니메이션 프로젝트(React) → 키 프레임의 스틸 → 프레임 → 렌더링 | references/animation.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()으로 설정됩니다. 리포지토리 외부에 유지하십시오(work/는 git 무시됨). 브랜드:pieces.Brand.from_logo('ref/logo.png')는 실제 색상을 측정합니다; 인쇄하고 먼저 로고 파일을 살펴보십시오(미디어 라이브러리는 오해의 소지가 있는 이름의 템플릿 로고로 가득합니다). - 스크립트 — 35-45초 동안 85-100단어. 첫 번째 문장에 후크, 문장당 하나의 아이디어, 후크를 반영하는 엔딩. 클라이언트 자료에 있는 것만 주장: 새로운 수치, 새로운 약속 없음. 건강 주제: 아웃트로에 "교육 콘텐츠" 메모. 사용자가 스크립트를 제공했다면 그대로 사용(제품 패키징이 다르게 철자하는 것만 수정하고 그렇게 말할 것).
- 음성 — 문장당 하나의 호출이므로 각 문장은 고유한 파일과 타이밍을 갖습니다:
vo/v01.mp3, v02…. 제공자:references/providers.md(Magnific MCPaudio_tts, Magnific RESTproviders/magnific.py voice, ElevenLabsproviders/elevenlabs.py). 그런 다음python scripts/media.py voice <folder>: 지속 시간 및 음성 구간; 모든 타이밍과 컷은 이로부터 파생됩니다. 음성 없음(화면에 클라이언트 스크립트, 음악만)? 4로 건너뜁니다. - 이미지 — 프롬프트 및 스타일 참조 트릭은
references/production.md§ 이미지에 있습니다. 이미지에 텍스트 없음을 요청하십시오. 그런 다음python scripts/media.py sheet-img <folder>를 실행하고review/imgs.jpg를 보십시오: 일관된 스타일, 잘못된 글자 없음, 로고가 올바른 것. - 먼저 스틸로 편집 —
pieces.source(name, 'img/x.png')를 사용하여reel.py를 작성하고(클립이 존재할 때까지 스틸 사용)python reel.py --preview를 실행하십시오.review/preview.jpg를 보십시오. 비디오에 투자하기 전에 리듬, 프레이밍 및 레이어를 수정하십시오. 이 단계가 릴이 만들어지는 단계입니다; 서두르지 마십시오. - 비디오 — 움직임이 필요한 각 샷당 하나의 클립, 자체 일러스트레이션에서(이미지-투-비디오). 샷 유형별 레시피와
references/production.md§ 비디오의simulate_cost.vid/<name>.mp4로 다운로드,media.py frames <folder>,media.py sheet-motion <folder>를 실행하고 어떤 클립도 객체를 발명하지 않았는지 확인하십시오. 2초 미만의 샷: 줌이 있는 스틸을 유지하면 비용이 들지 않습니다. - 음악 및 효과 — 하나의 음악 트랙(MCP를 통한 Lyria 또는 사용자의 것). 엔진은 첫 번째 시작에서 자르고 음성 아래에서 덕킹합니다. 효과는 번들로 제공됩니다:
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에서 가져온 콘택트 시트. 그 시트를 보십시오. 그런 다음media.py frame out/reel.mp4 <t>로 중요한 순간(자막 변경, 전환, 엔드 카드)에서 2-3개 전체 프레임을 보십시오. - 전달 —
out/reel.mp4+out/cover.jpg(reel.cover(t, 'out/cover.jpg')) + 캡션 텍스트 및 해시태그를.md로 + 소스(reel.py,img/,vo/,music/,ref/;frames/는 절대 안 됨). 아무것도 게시하지 마십시오: 클라이언트가 승인합니다. 생성된 것, 비용, 그리고 확인할 수 없었던 것(믹스를 들을 수 없음: 그렇게 말하고 대신 음량 수치를 가리키십시오)을 보고하십시오.
3. 실제 실수에서 비롯된 규칙
- 비용. 비디오가 지출의 >95%를 차지합니다. 시작하기 전에 하나의 클립 × 클립 수를 추정하십시오(
providers/costs.py또는 MCP의simulate_cost); 배치가 5,000 크레딧을 초과하면 중단하고 물으십시오. 12샷 릴은 약 3,000 크레딧이 소요되어야 하며 40,000이 아닙니다. - 모든 시트를 보십시오.
imgs.jpg,motion.jpg,preview.jpg,verify시트. 확인되지 않은 렌더링은 전달되지 않습니다. - 로고. 파일 이름을 절대 신뢰하지 마십시오. 여십시오. 작으면 측정된 색상으로 워드마크를 텍스트로 다시 빌드하거나(Schippers 예제에서 이렇게 함) 흰색 위에 구성하고 ×4 업스케일하십시오.
- 타사 브랜드. 클라이언트의 것이 아닌 로고나 아이덴티티를 절대 재사용하지 마십시오(예: 그들이 판매하는 서비스의 공급업체). 트랙터 제조업체의 배지는 클라이언트의 자체 푸티지에 있기 때문에 나타날 수 있습니다; 절대 추가되지 않습니다.
- 컷은 음성에서 나옵니다. 절대 눈으로 하지 마십시오:
caps.word_time(key, i)및media.py voice의 구간. - 짧은 클립. 1.5초 샷에도 3-5초를 생성하십시오. 클립을
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.mp3', 0.30) # 문장이 끝나는 위치 반환
caps.line('v01', 'Sentence with *key* *words*, / next block.', 'vo/v01.mp3', 0.30) # *hl* · / break · shown|spoken
caps.from_words('song', align.load_words('vo/chorus.words.json'), t0=2.0) # align.py / elevenlabs.tts_timed
t = caps.word_time('v01', 2) # 세 번째 단어가 발화되는 시간 → 여기서 자름
reel.shot(0.0, t, source('hero', 'img/hero.png', z=(1.0, 1.06), c=(.5, .45))) # frames/hero/가 존재할 때까지 Still
reel.shot(t, 5.0, Clip('hero', speed=1.0, start=0.25, z=(1.14, 1.24)))
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.png', '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 (아웃), eio (인-아웃), eback (팝). 이미지(그라디언트, 카드, 프레임)를 레이어 함수 외부에서 한 번 빌드하십시오; 텍스트와 알약은 캐시됩니다.
5. 그려진 애니메이션 (전체 참조: references/animation.md)
한 번 설정: Node.js 18+, 그런 다음 <skill>/animation 내에서 npm install 및 node <skill>/animation/cli.mjs doctor. 프로젝트는 package.json, src/index.jsx (registerRoot + 비디오당 하나의 <Composition>) 및 public/ (파일용)이 있는 폴더입니다. 컴포넌트는 'invokard-studio'에서 가져옵니다: useCurrentFrame, spring, interpolate, Sequence, Img + staticFile, OffthreadVideo, 'invokard-studio/google-fonts/<Family>'의 폰트, 'invokard-studio/three'의 3D.
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 모델, 업스케일 — 은 제공자로부터 옵니다
…
[번역을 위해 잘림]