Edge-TTS 스킬
개요
Microsoft Edge의 신경망 TTS 서비스를 node-edge-tts npm 패키지를 통해 사용하여 고품질 텍스트 음성 변환 오디오를 생성합니다. 여러 언어, 음성, 조절 가능한 속도/피치, 자막 생성을 지원합니다.
빠른 시작
트리거 또는 사용자 요청에서 TTS 의도를 감지하면:
- tts 도구 호출 (Clawdbot 내장): 텍스트를 음성으로 변환
- 도구가
MEDIA:경로를 반환 - Clawdbot이 현재 채널로 오디오 전달
// 예시: 내장 tts 도구 사용법
tts("음성으로 변환할 텍스트")
// 반환: MEDIA: /path/to/audio.mp3
트리거 감지
사용자 메시지에서 "tts" 키워드를 TTS 요청으로 인식합니다. 스킬은 자동으로 변환 전 텍스트에서 TTS 관련 키워드를 제거하여 트리거 단어 자체가 오디오로 변환되지 않도록 합니다.
고급 사용자 지정
Node.js 스크립트 사용
더 세밀한 제어를 위해 번들 스크립트를 직접 사용하세요:
TTS 변환기
cd scripts
npm install
node tts-converter.js "변환할 텍스트" --voice en-US-AriaNeural --rate +10% --output output.mp3
옵션:
--voice, -v: 음성 이름 (기본값: en-US-AriaNeural)--lang, -l: 언어 코드 (예: en-US, es-ES)--format, -o: 출력 형식 (기본값: audio-24khz-48kbitrate-mono-mp3)--pitch: 피치 조절 (예: +10%, -20%, default)--rate, -r: 속도 조절 (예: +10%, -20%, default)--volume: 볼륨 조절 (예: +0%, -10%, default)--save-subtitles, -s: 자막을 JSON 파일로 저장--output, -f: 출력 파일 경로 (기본값: tts_output.mp3)--proxy, -p: 프록시 URL (예: http://localhost:7890)--timeout: 요청 타임아웃 (밀리초, 기본값: 10000)--list-voices, -L: 사용 가능한 음성 목록 출력
설정 관리자
cd scripts
npm install
node config-manager.js --set-voice en-US-AriaNeural
node config-manager.js --set-rate +10%
node config-manager.js --get
node config-manager.js --reset
음성 선택
일반적인 음성 (전체 목록은 --list-voices 사용):
영어:
en-US-MichelleNeural(여성, 자연스러움, 기본값)en-US-AriaNeural(여성, 자연스러움)en-US-GuyNeural(남성, 자연스러움)en-GB-SoniaNeural(여성, 영국식)en-GB-RyanNeural(남성, 영국식)
다른 언어:
es-ES-ElviraNeural(스페인어, 스페인)fr-FR-DeniseNeural(프랑스어)de-DE-KatjaNeural(독일어)ja-JP-NanamiNeural(일본어)zh-CN-XiaoxiaoNeural(중국어)ar-SA-ZariyahNeural(아랍어)
속도 가이드라인
속도 값은 백분율 형식을 사용합니다:
"default": 일반 속도"-20%"~"-10%": 느리고 명확함 (튜토리얼, 이야기, 접근성)"+10%"~"+20%": 약간 빠름 (요약)"+30%"~"+50%": 빠름 (뉴스, 효율)
출력 형식
사용 사례에 따라 오디오 품질 선택:
audio-24khz-48kbitrate-mono-mp3: 표준 품질 (음성 메모, 메시지)audio-24khz-96kbitrate-mono-mp3: 고품질 (발표, 콘텐츠)audio-48khz-96kbitrate-stereo-mp3: 최고 품질 (전문 오디오, 음악)
리소스
scripts/tts-converter.js
node-edge-tts를 사용한 주요 TTS 변환 스크립트입니다. 음성, 속도, 볼륨, 피치, 형식을 사용자 지정하여 오디오 파일을 생성합니다. 자막 생성 및 음성 목록 출력을 지원합니다.
scripts/config-manager.js
TTS 설정(음성, 언어, 형식, 피치, 속도, 볼륨)에 대한 사용자 기본 설정을 관리합니다. 설정은 ~/.tts-config.json에 저장됩니다.
scripts/package.json
node-edge-tts 의존성이 포함된 NPM 패키지 설정 파일입니다.
references/node_edge_tts_guide.md
node-edge-tts npm 패키지에 대한 전체 문서입니다:
- 언어별 전체 음성 목록
- 운율 옵션 (속도, 피치, 볼륨)
- 사용 예시 (CLI 및 모듈)
- 자막 생성
- 출력 형식
- 모범 사례 및 제한 사항
음성 테스트
다양한 음성을 테스트하고 오디오 품질을 미리 들어보세요: https://tts.travisvn.com/
특정 음성 세부 정보나 고급 기능이 필요할 때 이 문서를 참조하세요.
설치
번들 스크립트를 사용하려면:
cd /home/user/clawd/skills/public/tts-skill/scripts
npm install
이 명령은 다음을 설치합니다:
node-edge-tts- TTS 라이브러리commander- CLI 인수 파싱
워크플로우
- 의도 감지: 사용자 메시지에서 "tts" 트리거 또는 키워드 확인
- 방법 선택: 간단한 요청은 내장
tts도구를, 사용자 지정이 필요하면scripts/tts-converter.js를 사용 - 오디오 생성: 대상 텍스트(메시지, 검색 결과, 요약) 변환
- 사용자에게 반환: tts 도구가
MEDIA:경로를 반환; Clawdbot이 전달 처리
테스트
기본 테스트
테스트 스크립트를 실행하여 TTS 기능 확인:
cd /home/user/clawd/skills/public/edge-tts/scripts
npm test
이 명령은 테스트 오디오 파일을 생성하고 TTS 서비스가 작동하는지 확인합니다.
음성 테스트
다양한 음성을 테스트하고 오디오 품질을 미리 들어보세요: https://tts.travisvn.com/
통합 테스트
빠른 테스트를 위해 내장 tts 도구 사용:
// 예시: 기본 설정으로 TTS 테스트
tts("이것은 TTS 기능 테스트입니다.")
설정 테스트
설정 지속성 확인:
cd /home/user/clawd/skills/public/edge-tts/scripts
node config-manager.js --get
node config-manager.js --set-voice en-US-GuyNeural
node config-manager.js --get
문제 해결
- 연결 테스트:
npm test를 실행하여 TTS 서비스에 접근 가능한지 확인 - 음성 가용성 확인:
node tts-converter.js --list-voices를 사용하여 사용 가능한 음성 목록 확인 - 프록시 설정 확인: 프록시를 사용하는 경우
node tts-converter.js "test" --proxy http://localhost:7890로 테스트 - 오디오 출력 확인: 테스트가
scripts디렉토리에test-output.mp3파일을 생성해야 함
참고 사항
- node-edge-tts는 Microsoft Edge의 온라인 TTS 서비스를 사용합니다 (업데이트되고 작동하는 인증)
- API 키가 필요 없음 (무료 서비스)
- 기본 출력 형식은 MP3입니다
- 인터넷 연결이 필요합니다
- 자막 생성 지원 (단어 수준 타임스탬프가 포함된 JSON 형식)
- 임시 파일 처리: 기본적으로 오디오 파일은 시스템 임시 디렉토리(Unix:
/tmp/edge-tts-temp/, Windows:C:\Users\<user>\AppData\Local\Temp\edge-tts-temp\)에 고유한 파일 이름(예:tts_1234567890_abc123.mp3)으로 저장됩니다. 파일은 자동으로 삭제되지 않습니다 - 호출 애플리케이션(Clawdbot)이 사용 후 정리해야 합니다. 영구 저장이 필요한 경우--output옵션으로 사용자 지정 출력 경로를 지정할 수 있습니다. - TTS 키워드 필터링: 스킬은 변환 전 텍스트에서 TTS 관련 키워드(tts, TTS, text-to-speech)를 자동으로 필터링하여 트리거 단어 자체가 오디오로 변환되지 않도록 합니다.
- 반복적인 설정의 경우
config-manager.js를 사용하여 기본값을 설정하세요. - 기본 음성:
en-US-MichelleNeural(여성, 자연스러움) Neural로 끝나는 신경망 음성은 표준 음성보다 더 높은 품질을 제공합니다.