Reelwright은(는) 무엇을 하나요?
Reelwright는 한 단락의 의도를 받아 완성된 1080p H.264/AAC 비디오를 반환합니다. 즉, 작성된 장면 계획, 장면별 일러스트레이션 한 장, 보이스오버, 하드코딩된 자막, 크로스페이드, 모든 샷에 적용된 느린 Ken Burns 효과, 그리고 파일이 실제로 재생 가능함을 입증하는 검증 보고서를 포함합니다.
모든 창작 요소는 Pollinations에서 제공됩니다. 유일한 로컬 의존성은 ffmpeg/ffprobe입니다.
사용 시기
- "X에 관한 60초짜리 영상을 만들어 줘."
- "이 글을 내레이션이 있는 슬라이드쇼로 바꿔 줘."
- "소셜 미디어용 릴이 필요해. 보이스오버와 자막 포함."
- "X를 다섯 장면으로 그림과 함께 설명해 줘."
다음의 경우에는 적합하지 않습니다: 긴 편집, 토크쇼 형식, 이미 보유한 영상, 또는 실제 카메라가 필요한 모든 것. Reelwright는 일러스트레이션이 포함된 설명 영상 도구이지 비디오 편집기가 아닙니다.
설정
npx @pollinations/cli auth login # 일회성 Pollinations 로그인
npm install # ffmpeg-static + ffprobe-static 설치
Reelwright는 --api-key, 그다음 POLLINATIONS_API_KEY, 마지막으로 polli auth login이 ~/.pollinations/credentials.json에 저장한 로그인 정보에서 키를 가져옵니다. 로그인 방식을 선호합니다. 사용자는 브라우저에서 기기 코드를 승인하며, 키가 대화에 노출되지 않습니다. CI에서 실행 시 환경 변수로 재정의하세요.
ffmpeg가 이미 PATH에 있으면 Reelwright가 이를 사용합니다. 그렇지 않으면 node_modules의 정적 바이너리로 대체한 후, $FFMPEG / $FFPROBE로 대체합니다.
실행
한 명령으로 브리프에서 완성 파일까지:
python3 skills/reelwright/scripts/reelwright.py make \
--brief examples/salt-road/brief.txt \
--out examples/salt-road \
--scenes 5 \
--transcribe
또는 단계별로 실행할 수도 있습니다. 문구가 중요할 때 더 좋은 방법입니다:
# 1. 계획: 텍스트 모델이 제목, 부제, 스타일 및 N개의 장면을 작성
python3 skills/reelwright/scripts/reelwright.py plan --brief brief.txt --out myreel --scenes 5
# 2. myreel/project.json을 수동으로 편집하여 약한 부분 수정 — 저렴하게 수정할 수 있는 시점입니다
# 3. 렌더링: 이미지, 음성, 클립, 믹싱
python3 skills/reelwright/scripts/reelwright.py render --project myreel
# 4. 확인: ffprobe로 결과를 확인하고, 선택적으로 오디오를 텍스트로 변환하여 대본과 비교
python3 skills/reelwright/scripts/reelwright.py check --project myreel --transcribe
출력물은 프로젝트 디렉터리에 저장됩니다:
| 파일 | 설명 |
|---|---|
project.json | 계획: 제목, 스타일, 장면, 모델 선택. 편집 가능. |
images/scNN.jpg | 장면당 하나의 일러스트레이션과 정확한 프롬프트가 포함된 scNN.prompt.txt. |
audio/scNN.mp3 | 장면별 내레이션. |
clips/scNN.mp4 | 장면별 무음 Ken Burns 클립. |
timings.json | 장면 시작/종료, 내레이션 길이, 파생된 장면 지속 시간. |
captions.ass | 제목, 부제, 장면별 자막, 크레딧 라인. |
reel.mp4 | 최종 결과물. |
poster.jpg | 1.2초 시점의 프레임, 썸네일용. |
render.json, check.json | 기계가 읽을 수 있는 렌더링 및 검증 보고서. |
타이밍 작동 방식
장면 지속 시간은 추측되지 않습니다. Reelwright는 ffprobe로 각 내레이션 MP3를 측정하고, 고정된 끝 패딩을 추가한 다음 해당 숫자를 기반으로 타임라인을 구축합니다. 자막도 동일한 타임라인에 작성되므로 자막이 해당 음성에서 벗어날 수 없습니다. 크로스페이드는 고정된 양만큼 클립을 겹치게 하며, xfade 오프셋은 동일한 지속 시간에서 계산됩니다.
이것이 대부분의 슬라이드쇼 생성기가 잘못 처리하는 부분입니다. PAD, FADE 또는 MIN_SCENE을 변경하면 모든 하위 항목이 자동으로 따라옵니다.
검증
check는 감성적인 검사가 아닙니다. 완성된 파일을 읽고 다음과 같은 경우 큰소리로 실패합니다:
- 비디오 또는 오디오 스트림이 없는 경우;
- 코덱이 H.264/AAC가 아닌 경우;
- 해상도가 1920x1080이 아니거나 프레임 레이트가 30이 아닌 경우;
- 실제 지속 시간이 계획된 타임라인에서 0.8초 이상 벗어난 경우;
- 타임라인이 참조하는 이미지 또는 오디오 파일이 없는 경우;
captions.ass에 장면 수보다 적은 대화 라인이 있는 경우;--transcribe사용 시: 최종 오디오의 음성 텍스트 변환이 대본 단어의 80% 미만을 포함하는 경우. 이를 통해 무음, 잘리거나 잘못된 언어의 트랙을 찾아냅니다.
마지막 검사가 가장 흥미롭습니다. 이는 MP4의 오디오가 요청한 내레이션이 실제로 맞는지, 즉 200 OK 응답에 빈 본문이 있는 경우가 아닌지 증명하는 저렴한 종단 간 검증입니다.
비용 및 모델
기본값이며 모두 플래그로 변경 가능합니다:
- 텍스트:
openai/gpt-5.4-nano— 계획 호출 한 번, 검증 실패 시 수정 호출 한 번 - 이미지:
tongyi-mai/z-image-turbo— 장면당 한 번 호출 - 음성:
openai/tts-1, 음성onyx— 장면당 한 번 호출
모든 기본 모델은 --transcribe 뒤의 openai/whisper-large-v3 변환 모델을 포함하여 무료 티어(paid_only: false)이므로, 무료 계정으로 전체 파이프라인을 처음부터 끝까지 실행할 수 있습니다.
다섯 장면 릴은 다섯 개의 이미지와 다섯 개의 짧은 음성 클립입니다. render를 다시 실행하면 이미 디스크에 있는 것을 재사용하며, --force는 재생성합니다. --seed는 이미지 생성을 재현 가능하게 만듭니다.
브리프 작성
브리프는 대본의 나침반 역할을 하므로, 형용사보다는 비트를 제공하세요:
제목: 소금 길.
바다가 왜 짠지 설명하는 50초짜리 미니 다큐멘터리. 화강암 산에서 바다까지 빗방울 한 방울을 따라갑니다. 순서대로 다섯 비트:
1. 빗방울이 화강암 산에 떨어져 산비탈을 따라 흐르기 시작합니다.
2. 산골짜기 시냇물이 암석을 깎으며 용해된 미네랄을 운반합니다.
3. 강이 넓어지며 미네랄을 바다로 운반합니다.
4. 태양이 바다를 데우고, 물은 수증기로 올라가고 소금은 남습니다.
5. 황혼의 해변에 소금 결정.
시각적 스타일: 에디토리얼 구아슈 일러스트레이션, 차분한 청록색과 호박색 팔레트, 질감이 있는 콜드프레스 종이, 부드러운 그레인, 시네마틱 와이드 16:9 구도.
브리프의 스타일 라인은 이후의 어떤 프롬프트 엔지니어링보다 가치가 있습니다. 이는 모든 이미지 프롬프트에 그대로 전달되며, 이는 다섯 개의 개별 생성물이 하나의 영화처럼 보이게 하는 요소입니다.
알아야 할 실패 모드
- Pollinations의 402 오류 — 키 뒤의 계정에 폴렌이 부족합니다. 스크립트가 JSON 덤프 대신 이를 명시적으로 알려줍니다.
image_prompt에 단어 포함 — 모델이 "증발이라고 표시된 지도"와 같은 텍스트를 쓰는 것을 좋아합니다. 시스템 프롬프트는 텍스트를 금지하며, 모든 이미지 프롬프트에는 "텍스트 없음, 글자 없음, 로고 없음" 꼬리가 붙지만, 잘못된 계획은project.json에서 수정하는 것이 다시 렌더링하는 것보다 저렴합니다.- 예상보다 긴 내레이션 — 장면이 음성에 맞춰 늘어납니다. 아무것도 잘리지 않으며, 비디오가 길어집니다. 고정된 지속 시간이 필요하면 장면당 더 적은 단어를 사용하세요.
- ffmpeg 없음 — 리포지토리에서
npm install을 실행하는 것이 의도된 해결책입니다. 오류 메시지에 패키지 이름과 환경 변수 이름이 모두 명시됩니다. - 라틴 문자가 아닌 자막 — ASS는 UTF-8을 지원하며, DejaVu Sans는 라틴어, 키릴 문자, 그리스어를 지원합니다. CJK 또는 아랍어의 경우
captions.ass에서 글꼴을 변경하고 렌더링 머신에 설치되어 있는지 확인하세요.