Shorts voiceover
스크립트를 넣으면 업로드 준비 완료된 Short가 나옵니다. 텍스트 길이로 캡션 타이밍을 추정하는 다른 도구들과 달리, 이 스킬은 완성된 음성 트랙을 실제로 전사하므로 모든 캡션이 단어가 발화되는 순간에 정확히 나타납니다.
사용 시점
- "이 스크립트 / 이 팁들 / 이 게시물을 Short(또는 Reel, TikTok)로 만들어줘."
- "보이스오버와 캡션이 있는 얼굴 없는 짧은 영상을 만들어줘." "내 목소리를 사용해줘."
- "이 스크립트들로 Short 5개 만들어줘" -> 스크립트 파일마다 한 번씩 실행.
단계
-
MIRAGEA_API_KEY가 설정되었는지 확인합니다(절대 출력하지 마세요). 음성: 사용자의 Miragea 음성 ID, 또는 사용자 음성 클립의 공개 URL과 해당 정확한 단어들.export MIRAGEA_VOICE_ID=...를 제안하세요. 사용자가 소유했거나 사용할 권한이 있는 음성만 복제하세요. -
스크립트를 작성합니다: 장면당 한 문단, 장면 사이는 빈 줄로 구분, 45-60초 Short의 경우 총 120-170단어. 장면 1은 후킹 문구로 시작하세요. 장면 시작 부분에 선택적으로
@file을 넣으면 배경을 지정할 수 있습니다:보이스오버를 프로처럼 만드는 세 가지 빠른 팁. @broll/desk.mp4 첫째, 부드러운 가구가 있는 작은 방에서 녹음하세요. 에코는 노이즈보다 고치기 어렵습니다. -
렌더링:
python3 scripts/short.py tips.txt --voice VOICE_ID # 그라데이션 배경 python3 scripts/short.py tips.txt --media ./broll --music bed.mp3 # 사용자 이미지/클립 + 음악 -
출력된 JSON에서
video와srt를 사용자에게 제공하세요. 편집 제안: 장면의 텍스트를 변경하고 다시 실행하면 해당 장면만 재음성화되고 나머지는 캐시에서 가져옵니다.
자동 처리 항목
| 단계 | 방법 |
|---|---|
| 음성 | 각 장면을 Miragea로 음성 변환; 장면 사이 0.18초 숨 |
| 캡션 타이밍 | 완성된 음성 트랙을 Miragea가 전사; 1-3단어 대문자 큐, 하단 1/3 위치 |
| 이미지 | 9:16으로 크롭, 장면마다 느린 줌 인/아웃 번갈아 적용 |
| 클립 | 9:16으로 크롭, 장면 길이에 맞춰 루프 또는 트리밍, 원본 오디오 제거 |
| 미디어 없음 | 애니메이션 그라데이션(4개 팔레트, 회전) |
| 음악 | 루프 처리, 볼륨 30%, 음성 아래에서 사이드체인 덕킹 |
| 음량 | -14 LUFS 통합, -1 dBTP (Shorts/TikTok/Reels 대상) |
| 재실행 | 장면별 음성 및 트랜스크립트 캐시; 변경되지 않은 장면은 비용 없음 |
옵션
| 플래그 | 기본값 | 설명 |
|---|---|---|
--voice ID / --ref-url URL --ref-text TEXT | 환경변수 | 저장된 Miragea 음성, 또는 공개 클립으로 복제 |
--media DIR | 없음 | @file이 없는 장면의 이미지/클립, 이름순 정렬 |
--music FILE | 없음 | 배경 음악, 자동 덕킹 |
--lowercase | 꺼짐 | 문장형 캡션 |
--no-captions | 꺼짐 | 캡션 생략 (트랜스크립션 비용 없음) |
--model | expressive | 또는 standard |
-o FILE | SCRIPT.short.mp4 | 출력 경로 |
비용 및 제한
음성: 문자당 (150단어 Short는 약 850자). 캡션 타이밍: 완성된 음성 1초당 3포인트 (25초 기준 약 75포인트); 이후 캐시됨. 실시간 요금: GET https://miragea.ai/v1/capabilities. 장면은 2,000자를 넘을 수 없습니다. 3분(YouTube Shorts 제한)을 초과하면 경고가 출력됩니다.
문제 해결
media file not found->@뒤의 경로는 스크립트나--media폴더 기준 상대 경로입니다.No such filter: gradients-> ffmpeg 버전이 6.1보다 오래됨; 업그레이드하거나--media에 이미지를 전달하세요.401키 오류,402miragea.ai에서 충전,429잠시 기다렸다가 재실행 (캐시된 것은 재청구되지 않음).
사용할 권한이 있는 음악과 영상만 사용하세요. 실제 스크립트와 출력 결과는 examples/ 디렉토리를 참고하세요.