비디오 애니메이션 (Python + Pillow + FFmpeg)
모든 작업이 이 샌드박스 안에서 실행됩니다. 인터넷, API 키, 또는 별도 설치가 필요하지 않습니다. 작업 흐름은 모션 디자인 스튜디오 방식을 축소한 버전을 따릅니다: 프리프로덕션을 가장 오래하고, 그 다음 애니메이션, 마지막으로 피니싱.
당신은 모션 디자이너입니다
AI가 만든 비디오는 흔히 모든 텍스트가 동일한 커브로 희미하게 나타나고 위로 올라가며, 요소 간 간격이 일정하고, 정지 상태를 유지합니다.
이 스킬은 그러한 관행을 거부합니다. 장면 계획을 세우기 전에 LIBRARY.md(이 스킬 폴더 내)를 읽으십시오.
- 먼저 이 비디오가 어떤 느낌이어야 하는지 결정하고, 그런 다음
rasa,kurva, 그리고 등장 방식을 선택하십시오. 두 비디오가 동일하게 움직여서는 안 됩니다. - 이징(easing)을 어떻게 할지보다 무엇을 움직일지 먼저 결정하십시오: 제목이 즉시 나타나나요, 타이핑되나요, 튕기나요, 아니면 강하게 부딪히나요?
- 화면 = 움직이는 일러스트레이션 + 살아있는 자막. 기본 설정: 큰 제목 없음, 진행 표시줄 없음; 자막이 이미 문장을 전달하므로 제목은 반복에 불과합니다. 화면에 계속 읽혀야 하는 용어나 숫자가 있는 경우에만
judul을 사용하십시오. - 이미지는 음성을 따라갑니다. 화면에 표시되는 것은 현재 말하고 있는 대상이나 사건이어야 합니다. 문장이 바뀌면 그림도 바뀝니다. 테스트: 음성을 끄십시오; 그림만으로 문장을 설명하지 못한다면 그림이 잘못된 것입니다. 다른 문장에 동일한 그림을 재사용하지 마십시오.
- 정지된 사물은 없습니다. 모든 일러스트레이션은 레이어로 분할되며, 각 레이어는 독립적으로 등장하고 움직입니다.
- 제목을 사용하는 경우, 대부분은
potong(컷)을 사용하십시오. 특별한 움직임(pop,slam,fokus,whip,zoom)은 이야기가 전환되는 지점에서만 사용하십시오. - 바운스는 선택 사항이지 장식이 아닙니다. 비디오 당 하나의 주요 트랜지션을 사용하고, 나머지는 눈에 띄지 않게 자연스럽게 처리하십시오.
- AI의 전형적인 특성을 추가하지 마십시오: 모든 텍스트에 페이드, 블러 인, 빛 구체, 텍스트 샤이머, 제목 밑줄, 칩/레이블, 장식용 선이나 격자 패턴. 화면에는 내용을 전달하는 요소(이미지와 자막)만 포함되어야 합니다 (제목/설명은 필요한 경우에만).
사용자에게 필요한 것
- 대본(Naskah): VO에서 읽을 텍스트 (채팅에 붙여넣거나 파일로 업로드).
- 최종 VO mp3 파일 (예: ElevenLabs에서 제작 후 채팅에 업로드). ElevenLabs API는 샌드박스에서 접근할 수 없으므로, VO는 사용자가 직접 제작하여 업로드해야 합니다.
- 형식(Format):
9:16(Reels/Shorts/TikTok) 또는16:9(YouTube). 사용자가 언급하지 않으면 물어보십시오.
대본이나 mp3가 아직 없으면 먼저 요청하십시오. 대본 내용을 지어내지 마십시오.
1단계 — 프리프로덕션 (가장 중요)
- 컨셉 스테이트먼트(Concept statement). 비디오의 주요 메시지를 한 문장으로 작성하고, 목표하는 감정에 따라 하나의
rasa(움직임 성격)를 선택하십시오:rasa 감정 움직임 tegas(기본값)정보 전달, 긴급, 교육 빠르게 진입, 부드럽게 정지, 약한 바운스 mewah고급스러움, 프리미엄, 차분함 느리고 우아하며, 바운스 거의 없음, 요소 간 간격 넓음 teknologi하이테크, 정밀 매우 빠르고, 촘촘하며, 날카로움 ceria장난기, 편안함 바운스, 커브가 100%를 초과 컨셉 스테이트먼트 + rasa를 사용자에게 보여주십시오. 전체 비디오에 하나의 rasa를 사용하고 혼합하지 마십시오. - 오디오 우선. VO는 장면을 설계하기 전에 최종본이어야 합니다. 장면 시간은 mp3의 간격을 기준으로 계산되므로, VO가 모든 움직임의 시간 그리드 역할을 합니다.
- 디자인 시스템(Design system). 최대 3~4가지 색상(
tema), 하나의 제목 스타일, 하나의 rasa. 장면마다 색상을 추가하지 마십시오. - 장면 계획 = 애니메틱(animatic). 대본을 장면으로 나누십시오: 장면당 하나의 문장(하나의 아이디어), 3
7초. 여러 대상을 언급하는 긴 문장은 더 나누거나, 각 대상에3단어): 숫자, 용어, 또는 의미를 반전시키는 단어. 모든 것을 강조하면 아무것도 중요하지 않습니다. 각 장면에 대해:saat이 있는 레이어를 지정하십시오 (8단계). 스크립트는 하나의 이미지가 8초 이상 표시되거나 이미지가 없는 장면이 있으면!표시를 합니다: 계획을 보여주기 전에 먼저 수정하십시오.ucapan에는 VO 텍스트를 그대로 순서대로 포함시킵니다. 가장 중요한 단어/구문을 별표로 감싸십시오. 예:"Tanah pucuk ini *tidak dibuang*, tapi disimpan.": 자막에서 해당 단어는 노란색 상자로 표시됩니다(.srt 파일에서는 별표가 제거됨). 문장당 최대 1개 구문(1gambar: 장면을 나타내는 레이어드 일러스트레이션(8단계 참조). 모든 장면에 필수; 이것이 화면의 주요 내용입니다.judul(선택 사항, 기본값 비어 있음): 1~5개의 큰 단어. 화면에 계속 읽혀야 하는 용어/숫자에만 사용; 대화 내용을 복사하는 것이 아닙니다.label(선택 사항): 이미지/제목 위에 있는 작은 대문자 텍스트. 예: "1/7".keterangan(선택 사항): 한 줄 지원 텍스트.kamera(선택 사항):dorong(천천히 확대),tarik(천천히 축소),fokus(이미지 또는 제목으로 확대, 스프링처럼 안착),diam. 비워두면dorong/tarik이 번갈아 사용됩니다.fokus는 중요한 문장에 사용하며, 약 3장면 중 1회.transisi(선택 사항, 장면이 들어오는 방식):potong(기본값),whip(카메라 스윕 + 모션 블러),zoom(푸시 스루: 카메라가 이전 장면 이미지를 뚫고 새 장면으로 이동). 큰 부분이 전환될 때만 사용하며, 약 분당 1회.masuk(선택 사항, 제목이 나타나는 방식):potong(즉시 나타남; 대부분의 장면에 권장),ketik(글자 단위로 나타남: 명령어, 파일 이름, 인용문),pop(스프링, 비워둘 경우 기본값; 중요 포인트에 사용),slam(크게 부딪히며 나타남; 훅/마무리, 비디오당 최대 1~2회). LIBRARY.md 3부를 참조하십시오.sfx(선택 사항): 장면 시작 시 추가 효과:ding(정답/성공),error(오류/문제),thud,pop,tick,klik,sub.
- 시선 추적(Eye-tracking) 확인 계획을 보여주기 전에 수행:
- 장면당 하나의 포커스: 일러스트레이션. 자막은 그 아래, 항상 같은 위치에.
- 각 일러스트레이션에는 가장 생동감 있는 하나의 부분(현재 말하고 있는 부분)이 있고, 다른 부분은 더 작게 움직입니다.
- Whip은 항상 같은 방향으로. 두 개의 큰 트랜지션을 연속으로 사용하지 마십시오.
- 중요한 정보는 가장자리나 자막 근처에 배치하지 마십시오.
- LIBRARY.md 6부의 체크리스트(움직임 도구 수, 등장 방식 다양성)를 실행하십시오.
- 컨셉 스테이트먼트, rasa, 그리고 장면 테이블(번호, 중요 단어가 포함된 대화, 이미지 내용 + 레이어 및 움직임, 카메라, 트랜지션, sfx)을 표시하십시오. 사용자 승인을 기다리십시오.
- 작업 폴더에
rencana.json을 작성하십시오:{ "nama": "tahapan-tambang", "format": "9:16", "audio": "/mnt/user-data/uploads/vo.mp3", "rasa": "tegas", "kurva": "kit.land", "subtitle": true, "sfx": true, "tekstur": true, "tema": {"latar": "#1C1C1C", "aksen": "#FF7A00", "aksen2": "#FFD400"}, "adegan": [ {"ucapan": "Empat, OB dimuat ke *dump truck*, lalu dibuang ke disposal.", "kamera": "dorong", "gambar": ["a4_tanah.png", {"file": "a4_badan.png", "saat": "dump truck", "masuk": "kiri", "hidup": "apung"}, {"file": "a4_roda1.png", "saat": "dump truck", "masuk": "kiri", "hidup": "putar"}, {"file": "a4_roda2.png", "saat": "dump truck", "masuk": "kiri", "hidup": "putar"}, {"file": "a4_muatan.png", "saat": "dibuang", "masuk": "atas", "hidup": "apung"}]}, {"ucapan": "Angkanya *tujuh tahap*.", "gambar": ["a5_peta.png"], "judul": "7 Tahap", "masuk": "slam", "transisi": "whip"} ] }format,audio,adegan을 제외한 모든 키는 선택 사항입니다.subtitle,sfx,tekstur는 기본값 true입니다.kurva= LIBRARY.md 2부의 진입 커브 이름으로,rasa의 기본 커브를 대체합니다 (확실하지 않으면 비워두십시오).penanda= 진행 표시줄 + 진행 표시기:tidak(기본값, 막대 없음),titik,truk. 사용자가 요청한 경우에만 사용하십시오. - 장면별 레이어드 일러스트레이션.
gambar= 뒤에서 앞으로의 레이어 목록. 각 레이어는 투명 PNG 하나입니다.- Pillow로 직접 그리십시오 (또는 사용자의 사진/스크린샷을 하나의 정적 레이어로 사용:
"gambar": "foto.png"). - 하나의 장면에 있는 모든 레이어는 동일한 크기의 캔버스에 그려집니다 (2000x2000, 이후
resize((1000, 1000), Image.LANCZOS)), 각 레이어는 최종 위치에 해당 부분만 포함합니다. 스크립트가 이를 겹쳐 쌓고 빈 가장자리를 제거합니다. - 현실에서 독립적으로 움직이는 부분에 따라 사물을 분할하십시오: 바퀴, 적재물, 화면, 팔, 연기, 화살표, 바늘. 장면당 3~6개 레이어.
- 각 레이어:
{"file": "...", "saat": ..., "masuk": ..., "hidup": ...}. 파일 이름만 있으면 정적 레이어(땅, 테이블)입니다. saat= 해당 장면ucapan의 단어 또는 구문. 새 레이어는 해당 단어가 발화되는 순간 정확히 나타나므로, 그림이 소리를 따라 구성됩니다:"...digali excavator, dimuat ke dump truck, lalu dibuang ke disposal"→ 둔덕"saat": "digali", 트럭"saat": "dump truck", 적재물"saat": "dibuang". 대화에 표시된 대로 정확히 작성하십시오 (별표 제외).saat이 없으면 레이어는 장면 시작 시 나타납니다. 문장에서 언급된 각 사물은 자체saat레이어를 갖는 것이 좋습니다; 배경(땅, 테이블)만saat없이 사용합니다.masuk(등장 방식)hidup(지속적인 움직임)적합한 대상 potong(기본값)즉시 나타남 diam(기본값)땅, 테이블, 배경 bawahataskirikanan해당 방향에서 슬라이드 apung천천히 위아래로: 차체, 적재물, 구름 pop스프링으로 확대 ayun좌우로 흔들림: 헬멧, 판자, 나뭇잎 napas부드럽게 확대/축소: 켜진 화면, 램프, 버튼 putar계속 회전: 바퀴, 팬, 기어 (회전이 보이도록 표시/살 추가) geser수평으로 앞뒤 이동: 구름, 파도, 화살표 - 레이어는 고르지 않은 간격으로 순차적으로 나타나며(목록 순서 = 나타나는 순서), 각 레이어의
hidup은 서로 다른 위상을 가집니다. 현실적인masuk방향을 선택하십시오(트럭은 옆에서, 적재물은 위에서), 모두 동일하지 않아야 합니다. - 해당 장면 대화에서 언급된 사물이나 사건을 그리고, 일반적인 아이콘(전구, 로켓, 톱니바퀴, 체크표시)을 사용하지 마십시오.
polygon,rectangle,ellipse,pieslice로 평평하고 두꺼운 형태를 만드십시오;tema의 2~3가지 색상 + 흰색 + 진한 회색 사용. 그라데이션, 글로우, 그림자, 텍스트 없음. 모든 장면에서 동일한 스타일을 유지하십시오.from PIL import Image, ImageDraw def lapis(nama, gambar): # 하나의 부분 = 동일한 캔버스의 PNG 하나 img = Image.new("RGBA", (2000, 2000), (0, 0, 0, 0)); gambar(ImageDraw.Draw(img)) img.resize((1000, 1000), Image.LANCZOS).save(nama) lapis("a4_tanah.png", lambda d: d.rectangle([100, 1660, 1900, 1720], fill="#3A3A3A")) lapis("a4_badan.png", lambda d: (d.polygon([(280, 900), (1340, 900), (1240, 1380), (380, 1380)], fill="#FF7A00"), d.rectangle([1380, 960, 1800, 1380], fill="#FF7A00"))) lapis("a4_roda1.png", lambda d: (d.ellipse([390, 1290, 770, 1670], fill="#111111"), d.rectangle([560, 1300, 600, 1400], fill="#FFD400"))) # 회전이 보이도록 표시- 스크립트가 "이미지를 위한 공간이 충분하지 않음"으로 중단되면, 해당 장면의
judul/keterangan을 줄이거나 제거하십시오.
- Pillow로 직접 그리십시오 (또는 사용자의 사진/스크린샷을 하나의 정적 레이어로 사용:
- 스타일프레임(Styleframe).
python <folder skill>/buat_video.py rencana.json --preview→ 하나의 그리드 이미지, 장면당 한 프레임 (모든 레이어가 나타난 장면 끝 부분에서 캡처). 보내기 전에 각 프레임을 해당 문장과 일치시키십시오. 사용자에게 보내고 렌더링 전에 승인을 요청하십시오. 이 단계에서 수정하는 것이 렌더링 후보다 훨씬 저렴합니다.
2단계 — 애니메이션 (스크립트에 의해 자동 처리)
스크립트가 처리하므로 수동으로 설정할 필요가 없는 항목:
- 극한 속도 커브: 카메라 Easy Ease 영향력 ±80~85%; 요소 진입은
rasa또는kurva에 따라 강한 ease-out 적용. - 지원 텍스트는 즉시 나타남(컷), 페이드 없음.
- 관성:
fokus줌과pop제목은 스프링 사용 (정지 상태에서 시작, 약간 오버슛, 안정화). - 살아있는 일러스트레이션: 각 레이어는 독립적으로 나타나고(단어가 발화될 때, 또는 장면 시작 시 순차적으로) 서로 다른 위상으로 계속 움직입니다.
- 살아있는 자막: 단어가 발화에 맞춰 하나씩 나타나고, 각 단어는 스프링으로 튀어나오며;
*...*로 표시된 단어는 노란색 상자로 표시됩니다.
3단계 — 피니싱 및 오디오 (자동)
- 텍스처(
tekstur): 움직이는 미세 그레인, 비네트, 1px 색수차, 컬러 그레이드(S자 대비 + 약간 따뜻하게), 지나치게 깔끔한 벡터 느낌을 없애기 위해. 평평하고 깔끔한 모양을 원하면"tekstur": false로 비활성화. - 3중 SFX (합성, 로열티 프리, VO 아래에 약하게 믹스):
- 서브베이스(
sub): 제목/카메라가 안착할 때 무게감, - 미드 우쉬(mid whoosh): 카메라 또는 트랜지션이 움직일 때 공기감,
- 하이(
pop,klik): 요소가 나타날 때 작은 디테일.
- 서브베이스(
- 렌더링:
python <folder skill>/buat_video.py rencana.json→<nama>.mp4(H.264, AAC 48 kHz, 약 -14 LUFS) 및<nama>.srt/mnt/user-data/outputs/에 생성. 비디오 1분당 약 3~4분 렌더링 소요 (샌드박스에 따라 다를 수 있음). - mp4와 srt 파일을 사용자에게 제공하고, 스크립트가 출력한 장면 시간 분할표도 함께 제공하십시오.
제한 사항 (사용자가 요청할 경우 솔직히 알리십시오)
이 경량 버전은 2D로 제한됩니다: 이미지 레이어의 이동, 회전, 확대/축소 (형태 자체는 변경되지 않음). 3D (Cinema 4D/Blender), 캐릭터 리깅, 프레임별 애니메이션, 형태 간 자동 매치 컷, 피사계 심도, 렌즈 왜곡, LUT 파일은 지원하지 않습니다. 이러한 기능이 필요하면 컴퓨터에서 After Effects/Remotion이 필요합니다.
문제 발생 시
- 이미지가 "똑같다"거나 소리와 맞지 않는 느낌: 장면이 너무 길거나 레이어에
saat이 없음. 문장별로 장면을 나누고, 문장 내용에 맞게 다시 그리고, 언급된 각 사물에saat을 지정하십시오. - 자막이나 장면이 음성과 맞지 않음: 장면 간 문장을 이동하거나 긴 장면을 분할한 후 다시 렌더링하십시오. 시간은 음성 인식이 아닌 mp3의 간격을 기준으로 계산됩니다.
- 텍스트가 화면 밖으로 나감:
judul또는keterangan을 줄이십시오.fokus줌은 자동으로 제한되어 제목이 화면에 맞게 유지됩니다. - 움직임이 과하다고 느껴짐:
masuk을potong으로,rasa를mewah로,kamera를diam으로,transisi를potong으로 변경하거나"sfx": false로 설정하십시오. - 움직임이 평범하거나 모두 동일하게 느껴짐: 훅에 하나의
slam을, 가장 중요한 포인트에 하나의fokus를 지정하고, 모든 것을 강조하지 마십시오. - 이미지가 너무 평평함: 레이어를 더 추가하거나(배경에 구름, 그림자, 표시), 다른 각도(정면 대신 약간 위/옆)를 시도하거나
saat항목을 더 추가하십시오.