이중언어-영상-자막-스킬은(는) 무엇을 하나요?
중국어 대본을 MP4에 강제 정렬(stable-ts)하고, 영어로 번역한 후, 3개 트랙 소프트 멀티플렉싱 및 이중언어 하드서브 번인을 에이전트 파이프라인에서 수행합니다.
개요
이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 다음을 수행할 수 있도록 합니다:
stable-ts를 사용하여 중국어 대본을 MP4 비디오에 강제 정렬- 정렬된 자막을 영어로 자동 번역
- 3개의 소프트 자막 트랙(중국어, 영어, 이중언어)을 MP4에 멀티플렉싱
- 이중언어 하드서브를 비디오에 번인하여 단일 출력 파일 생성
전제 조건
ffmpeg와ffprobe가 시스템에 설치되어 있어야 함- Python 패키지:
stable-ts,openai-whisper,ffmpeg-python - 번역 API 키 (예: OpenAI, DeepL 등)
사용법
# 설정 파일을 사용하여 스킬 실행
skill run --config config.yaml --input input_video.mp4
# 또는 직접 인수 전달
skill run --input input_video.mp4 --lang zh --output output_video.mp4
설정
config.yaml 예시:
input: "input_video.mp4"
output: "output_video.mp4"
language: "zh"
translate_to: "en"
hardsub: true
softsub: true
model: "base" # whisper 모델 크기: tiny, base, small, medium, large
주요 기능
- 강제 정렬 -
stable-ts를 사용하여 중국어 대본을 MP4에 프레임 단위로 정렬 - 번역 - 정렬된 자막을 OpenAI 또는 다른 번역 API를 사용하여 영어로 번역
- 멀티플렉싱 - 3개의 소프트 자막 트랙(원본, 번역, 이중언어)을 MP4 컨테이너에 추가
- 하드서브 - 이중언어 자막을 비디오 프레임에 직접 번인하여 호환성 극대화
워크플로우
- 입력 MP4 및 중국어 대본 수신
stable-ts로 대본 강제 정렬- 정렬된 자막을 영어로 번역
- 3개의 SRT 자막 파일 생성
- FFmpeg로 소프트 자막 트랙 멀티플렉싱
- FFmpeg로 이중언어 하드서브 번인
- 최종 출력 MP4 반환
에이전트 통합
이 스킬은 skill.json을 통해 AI 에이전트에 등록되며, run 엔드포인트를 통해 호출됩니다. 에이전트는 자막 처리, 번역, 멀티플렉싱의 복잡성을 추상화하여 단일 명령으로 실행할 수 있습니다.
문제 해결
- ffmpeg를 찾을 수 없음: 시스템에 FFmpeg가 설치되어 있는지 확인하세요.
- 번역 실패: API 키가 올바르게 설정되었는지, 할당량이 남아 있는지 확인하세요.
- 자막 싱크 불일치: 더 큰 whisper 모델을 사용하거나
--beam_size를 조정해 보세요.