🎙️ TTS-Skill — 다중 엔진 텍스트 음성 변환
TTS-Skill은 여러 백엔드를 사용하여 음성을 생성할 수 있는 단일 진입점을 제공하며, 일관된 출력 파일 이름 지정 및 장시간 작업에 대한 진행률 피드백을 지원합니다.
엔진
- qwen3-tts: 참조 오디오 및 텍스트를 사용한 로컬 음성 복제
- edge-tts: 속도/피치/스타일 제어가 가능한 온라인 음성
- openai-tts: API를 통한 OpenAI 음성 생성
명령어 구문
/tts-skill [엔진] [텍스트] --voice [음성-키워드] [기타 옵션]
Python 진입점을 사용하는 경우:
python tts-skill.py [엔진] [텍스트] --voice [음성-키워드]
텍스트 입력
텍스트를 위치 인수로 전달하거나 --text-file / -f를 사용하여 파일에서 읽어옵니다.
예시:
python tts-skill.py qwen3-tts --text-file "input\\text.txt" --voice 寒冰射手
참고:
--text-file은 상대 경로와 절대 경로를 모두 지원하며, 상대 경로는 현재 작업 디렉터리를 기준으로 확인됩니다.- 위치 텍스트와
--text-file이 모두 제공된 경우--text-file이 우선합니다. - UTF-8을 권장합니다(UTF-8 BOM 지원됨). 디코딩 오류 시 GBK로 대체됩니다.
엔진 스크립트를 직접 호출할 수도 있습니다:
python engines/qwen3-tts-cli.py --text-file "input\\text.txt" --voice 寒冰射手
python engines/edge-tts-cli.py --text-file "input\\text.txt" --voice xiaoxiao
python engines/openai-tts-cli.py --text-file "input\\text.txt" --voice alloy
로컬 음성 에셋 (Qwen3-TTS)
복제 음성을 추가하려면 assets/ 디렉터리에 다음과 같은 파일 쌍을 넣으세요:
assets/Lei.wav
assets/Lei.txt
지원되는 오디오 형식: .wav, .mp3, .m4a, .flac.
그런 다음 다음 명령어를 실행합니다:
python tts-skill.py qwen3-tts "테스트 텍스트" --voice Lei
출력
--output이 제공되지 않은 경우:
- 출력 디렉터리:
output/ - 파일 이름 패턴:
YYYYMMDD_HHMMSS_<첫-6자>.<확장자>
진행률 및 시간 (Qwen3-TTS)
Qwen3-TTS 작업은 예상 완료 시간(ETA)이 포함된 실시간 진행률 표시줄을 출력합니다. 완료 후 tts-skill.py는 다음 정보를 출력합니다:
- 총 실행 시간
- 총 문자 수 및 중국어 문자 수
- 중국어 문자당 평균 초(중국어가 없는 경우 문자당)
프로젝트 구조
tts-skill/
├── .trae/
│ └── plans/
├── assets/
│ ├── Lei.txt
│ ├── 寒冰射手.txt
│ ├── 布里茨.txt
│ └── 赵信.txt
├── engines/
│ ├── edge-tts-cli.py
│ ├── edge-tts.config
│ ├── openai-tts-cli.py
│ ├── openai-tts.config
│ ├── qwen3-tts-cli.py
│ └── qwen3-tts.config
├── input/
│ └── text.txt
├── output/
├── tts-skill.py
├── INSTALL.md
├── INSTALL.zh-CN.md
├── README.md
├── README.zh-CN.md
├── SKILL.md
└── SKILL.zh-CN.md
중국어 사양
SKILL.zh-CN.md를 참조하세요.