voxcpm2-video-dub-skill은(는) 무엇을 하나요?
VoxCPM2 비디오 더빙 스킬 – 에이전트 파이프라인을 위한 중국어/다국어 숏폼 비디오 음성 클론 더빙.
개요
이 스킬은 VoxCPM2 모델을 통합하여 AI 에이전트가 비디오 파일과 대본을 입력받아 원본 화자의 음성을 클론하고 새로운 대사로 더빙된 비디오를 생성할 수 있도록 합니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 프레임워크
사전 요구 사항
- Python 3.8+
- VoxCPM2 모델 가중치 (로컬 또는 API 접근)
- FFmpeg (비디오/오디오 처리용)
빠른 시작
# 스킬 저장소 클론
git clone https://github.com/Young140430/voxcpm2-video-dub-skill.git
cd voxcpm2-video-dub-skill
# 의존성 설치
pip install -r requirements.txt
사용법
다음 예제는 Claude Code에서 이 스킬을 호출하는 방법을 보여줍니다:
# Claude Code 스킬 호출 예시
import voxcpm2_skill
result = voxcpm2_skill.dub_video(
video_path="input.mp4",
script="새로운 대본 내용입니다.",
speaker_sample="sample.wav", # 음성 클론용 샘플
target_lang="ko" # 대상 언어 코드
)
print(f"더빙 완료: {result['output_path']}")
API 참조
| 매개변수 | 타입 | 설명 |
|---|---|---|
video_path | str | 입력 비디오 파일 경로 |
script | str | 더빙할 새 대본 |
speaker_sample | str | 화자 음성 샘플 파일 경로 |
target_lang | str | 대상 언어 코드 (예: 'zh', 'en', 'ja', 'ko') |
output_format | str | (선택 사항) 출력 비디오 형식, 기본값 'mp4' |
환경 변수
VOXCPM2_MODEL_PATH: VoxCPM2 모델 가중치 경로FFMPEG_PATH: FFmpeg 실행 파일 경로 (선택 사항, 기본값은 시스템 PATH)
고급 구성
스킬은 다음과 같은 커스텀 구성을 지원합니다:
- 음성 속도 조정
- 피치 보정
- 배경 음악 믹싱 레벨
자세한 내용은 공식 문서를 참조하세요.
라이선스
MIT