Communitygithub.com

Invokard Studio

코드로 릴(reel)을 작성하면 엔진이 MP4 영상으로 제작해주는 도구입니다. Python 파일 하나로 장면, 레이어, 음성을 정의하고 Pillow와 ffmpeg으로 렌더링합니다.

Invokard Studio란 무엇인가요?

Invokard Studio는 텍스트 기반 스크립트(Python) 하나로 전문가 수준의 MP4 릴을 생성할 수 있는 AI 에이전트 스킬입니다. 사용자가 `reel.py`에 이미지, 클립, 텍스트 레이어(헤드라인, 칩, 목록 항목, 차트, 전환, 엔드 카드), 음성, 배경 음악, 효과음을 시간 순서대로 정의하면, 엔진 `scripts/reelkit.py`가 Pillow로 모든 프레임을 구성하고 ffmpeg로 인코딩하며 오디오를 믹싱합니다. 모든 타이포그래피와 박스, 애니메이션은 엔진에서 생성되므로 선명하고 브랜드에 일치하며 정확한 타이밍을 갖습니다. 더불어 React 컴포넌트를 헤드리스 브라우저에서 프레임 단위로 렌더링하는 `animation/` 엔진을 통해 운동 타이포그래피, 애니메이션 광고, 성장 차트, 3D 제품, 물리 효과, 파티클 등을 제작할 수 있습니다. Claude Code, Cursor, Codex 등에서 직접 명령을 실행할 수 있으며, 사용자는 최소한의 프롬프트로 전체 워크플로우(자료 선택, 스크립트, 음성, 이미지, 편집, 영상, 음악, 렌더링, 전달)를 제어할 수 있습니다. 최종 결과물은 H.264+AAC로 인코딩된 30fps MP4이며, 클라이언트 승인 후 소스 파일과 함께 전달됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Octonove/invokard-studio/tree/main/skills/invokard-studio

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

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

문서

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. 워크플로우

  1. 작업 폴더 — 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')는 실제 색상을 측정합니다; 인쇄하고 먼저 로고 파일을 살펴보십시오(미디어 라이브러리는 오해의 소지가 있는 이름의 템플릿 로고로 가득합니다).
  2. 스크립트 — 35-45초 동안 85-100단어. 첫 번째 문장에 후크, 문장당 하나의 아이디어, 후크를 반영하는 엔딩. 클라이언트 자료에 있는 것만 주장: 새로운 수치, 새로운 약속 없음. 건강 주제: 아웃트로에 "교육 콘텐츠" 메모. 사용자가 스크립트를 제공했다면 그대로 사용(제품 패키징이 다르게 철자하는 것만 수정하고 그렇게 말할 것).
  3. 음성 — 문장당 하나의 호출이므로 각 문장은 고유한 파일과 타이밍을 갖습니다: vo/v01.mp3, v02…. 제공자: references/providers.md (Magnific MCP audio_tts, Magnific REST providers/magnific.py voice, ElevenLabs providers/elevenlabs.py). 그런 다음 python scripts/media.py voice <folder>: 지속 시간 및 음성 구간; 모든 타이밍과 컷은 이로부터 파생됩니다. 음성 없음(화면에 클라이언트 스크립트, 음악만)? 4로 건너뜁니다.
  4. 이미지 — 프롬프트 및 스타일 참조 트릭은 references/production.md § 이미지에 있습니다. 이미지에 텍스트 없음을 요청하십시오. 그런 다음 python scripts/media.py sheet-img <folder>를 실행하고 review/imgs.jpg를 보십시오: 일관된 스타일, 잘못된 글자 없음, 로고가 올바른 것.
  5. 먼저 스틸로 편집 — pieces.source(name, 'img/x.png')를 사용하여 reel.py를 작성하고(클립이 존재할 때까지 스틸 사용) python reel.py --preview를 실행하십시오. review/preview.jpg를 보십시오. 비디오에 투자하기 전에 리듬, 프레이밍 및 레이어를 수정하십시오. 이 단계가 릴이 만들어지는 단계입니다; 서두르지 마십시오.
  6. 비디오 — 움직임이 필요한 각 샷당 하나의 클립, 자체 일러스트레이션에서(이미지-투-비디오). 샷 유형별 레시피와 references/production.md § 비디오의 simulate_cost. vid/<name>.mp4로 다운로드, media.py frames <folder>, media.py sheet-motion <folder>를 실행하고 어떤 클립도 객체를 발명하지 않았는지 확인하십시오. 2초 미만의 샷: 줌이 있는 스틸을 유지하면 비용이 들지 않습니다.
  7. 음악 및 효과 — 하나의 음악 트랙(MCP를 통한 Lyria 또는 사용자의 것). 엔진은 첫 번째 시작에서 자르고 음성 아래에서 덕킹합니다. 효과는 번들로 제공됩니다: pieces.sfx('whoosh'|'pop'|'shimmer'|'chime'|'typing'|'shutter'|'coaster'|'fridge'). 음성이 없을 때 비트에 맞춰 컷: media.py beats → references/footage.md.
  8. 렌더링 및 확인 — python reel.py, 그런 다음 python scripts/media.py verify out/reel.mp4: 사양, 음량(목표 −14 LUFS) 및 최종 MP4에서 가져온 콘택트 시트. 그 시트를 보십시오. 그런 다음 media.py frame out/reel.mp4 <t>로 중요한 순간(자막 변경, 전환, 엔드 카드)에서 2-3개 전체 프레임을 보십시오.
  9. 전달 — 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 모델, 업스케일 — 은 제공자로부터 옵니다

…

[번역을 위해 잘림]

관련 스킬