설명 동영상 (Explainer Video)
완성된 설명 동영상은 단어에 따라 그림이 움직이는 MP4입니다: 각 애니메이션은 내레이터가 설명하는 구절에 도달할 때 시작되며, 자막은 음성 자체의 문자 타임스탬프를 기준으로 시간이 맞춰집니다. 작업은 프로젝트 폴더 내의 파이프라인으로 구성됩니다: narration.py (스크립트), scenes.py (Manim 장면), video.json (제목, 음성), screens/ (스크린샷), kit/ (벤더드 툴킷, 프로젝트 루트에서 python -m kit <command>로 실행).
모든 컷(새 버전, 단축 편집, 새 음성)은 scripts/new_project.py DEST --from OLD로 만든 새 프로젝트 폴더입니다. 이전 컷은 재생 가능하며 변경되지 않은 상태로 유지됩니다; 합성된 문장은 프로젝트 외부의 콘텐츠에 의해 캐시되므로, 컷은 변경된 문장에 대해서만 비용이 발생합니다.
API 키는 환경 변수 ELEVENLABS_API_KEY에서 가져옵니다. 사용자가 사용하는 시크릿 관리자(op run --, av inject +ELEVENLABS_API_KEY --, 일반 export)를 통해 음성 명령을 실행하세요; 키를 출력, 로깅 또는 작성하지 마세요.
단계
1. 사실 시트 (Facts sheet)
사용자의 브리핑, 저장소 및 설정, 사용자에게 질문하여 동영상이 주장할 내용을 수집합니다. 각 주장을 확인됨(설정, 화면 또는 사용자의 말에서 확인) 또는 예시용(자리 표시자, 예시, 개념적 레이아웃)으로 기록합니다. 시청자, 목표 길이, 그리고 반드시 잘라내야 할 내용을 명확히 합니다.
계획한 모든 화면상 또는 음성상의 주장이 확인된 내용으로 추적 가능하고, 예시용 주장들은 결과 노트에 나열되면 완료됩니다. 가장 자주 잘못되는 주장들은 references/script.md를 참조하세요.
2. 프로젝트 (Project)
새 동영상은 python3 <skill>/scripts/new_project.py DEST, 새 컷은 --from OLD를 사용합니다. template/requirements.txt를 venv에 설치합니다(Manim은 시스템에 Cairo, Pango 및 ffmpeg가 필요합니다). video.json에서 name, title, voice를 설정합니다.
python -m kit draft && python -m kit build --low가 번들된 예제(또는 복사된 컷)를 out/에 빌드하면 완료됩니다.
3. 스크립트 (Script)
narration.py를 작성합니다: 재생 순서대로 장면을 배치하고, 각 장면은 (id, caption, spoken) 세그먼트(1~3문장)의 목록입니다. 분당 약 150단어를 목표로 예산을 잡고, 음성을 빠르게 하기보다 실제 오디오가 최종 길이를 결정하도록 합니다. 이름의 발음은 pronunciations.json에 넣습니다.
스크립트를 표(장면, 내레이션, 화면에 표시할 내용)로 사용자에게 보여주고 사용자만이 답할 수 있는 질문을 합니다. 사용자가 문구를 승인하면 완료됩니다: 합성에는 비용이 들지만, 그 전에 스크립트를 편집하는 것은 무료입니다.
4. 드래프트 오디오로 애니메이션 (Animate on draft audio)
python -m kit draft는 균일한 문자 타이밍으로 무료 자리 표시자 내레이션을 만들어 음성 비용을 지불하기 전에 장면을 배치할 수 있게 합니다. scenes.py에 장면당 하나의 Narrated(다이어그램) 또는 ScreenScene(스크린샷) 클래스를 작성하고, say / until / done으로 모든 변경을 구동합니다. python -m kit build --low로 반복하고 프레임을 확인합니다.
모든 세그먼트가 단어에 따라 변하는 그림을 가지고 있고, python -m kit timing이 침묵 간격을 보고하지 않으며, 낮은 해상도 미리보기에서 겹치는 텍스트나 빈 스테이지가 없으면 완료됩니다. 장면을 작성하기 전에 references/animation.md를 읽고, 라이브 앱을 캡처하기 전에 references/screens.md를 읽으세요.
5. 음성 (Voice)
음성을 선택하지 않은 경우 오디션: python -m kit voices, 그런 다음 어려운 이름이 포함된 문장으로 python -m kit audition ID1 ID2 ID3를 실행하고 사용자가 직접 듣고 선택하도록 합니다. 그런 다음 python -m kit narrate --dry-run으로 문자 비용을 확인하고 python -m kit narrate를 실행합니다.
narrate가 합성할 세그먼트가 0개라고 보고하면 완료됩니다. 음성 설정, 복제된 음성, 크레딧 및 키 권한에 대해서는 references/narration.md를 읽으세요.
6. 빌드 및 확인 (Build and verify)
python -m kit build(전체 해상도), 그런 다음 python -m kit verify --speech. out/의 연락처 시트와 모든 장면의 전체 해상도 프레임을 검토하고 발견된 문제를 수정합니다. 새 음성은 템포를 변경하므로, 음성 교체는 항상 전체 재렌더링을 의미하며 사운드트랙 교체로 대체할 수 없습니다.
references/verify.md의 모든 검사가 통과되거나 해당 예외가 설명되면 완료됩니다.
7. 전달 (Deliver)
MP4, SRT, 스크립트 및 연락처 시트의 절대 경로; 길이; 음성 및 모델; 확인 번호; 1단계의 예시용 또는 미확인 목록; 재빌드 명령을 보고합니다. 드래프트 오디오를 완성된 내레이션이라고 부르지 마세요: assemble은 어떤 세그먼트라도 드래프트 상태인 동안 최종 빌드를 거부합니다.