🎙️ EdgeTTS - Microsoft Edge Text-to-Speech 음성 합성 서비스

✨ 주요 기능

🌍 다국어 지원

🎵 고급 음성 제어

📝 텍스트 처리

💾 사용자 경험

🏗️ 시스템 아키텍처

┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ React │ │ Nginx │ │ FastAPI │
│ Frontend │◄──►│ Proxy │◄──►│ Backend │
│ (Vite) │ │ (/edge-api)│ │ (Port 3701) │
└─────────────┘ └──────────────┘ └─────────────┘
 │
 ▼
 ┌─────────────────┐
 │ Microsoft │
 │ Edge TTS API │
 └─────────────────┘

🛠️ 기술 스택

Backend

Frontend

Infrastructure

📦 설치 방법

1. 저장소 클론

git clone https://github.com/purestory/edgetts.git
cd edgetts

2. 백엔드 설정

# Python 가상환경 생성
python3 -m venv .venv
source .venv/bin/activate
# 의존성 설치
pip install -r requirements.txt

3. 프론트엔드 설정

cd frontend
npm install
npm run build

4. 서비스 설정

# EdgeTTS 서비스 파일 복사
sudo cp edgetts.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable edgetts.service
sudo systemctl start edgetts.service

5. Nginx 설정

# /etc/nginx/sites-available/your-domain
location = /edgetts {
 return 301 /edgetts/;
}
location ^~ /edgetts/ {
 alias /path/to/edgetts/frontend/dist/;
 index index.html;
 try_files $uri $uri/ /edgetts/index.html;
 
 location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
 expires 1y;
 add_header Cache-Control "public, immutable";
 }
}
location ^~ /edge-api/ {
 rewrite ^/edge-api/(.*)$ /1ドル break;
 proxy_pass http://localhost:3701;
 proxy_set_header Host $host;
 proxy_set_header X-Real-IP $remote_addr;
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_buffering off;
 client_max_body_size 50G;
}

🚀 사용법

웹 인터페이스

API 사용법

음성 합성

curl -X POST "http://your-domain/edge-api/synthesize" \
 -H "Content-Type: application/json" \
 -d '{
 "text": "안녕하세요! EdgeTTS입니다.",
 "voice": "ko-KR-SunHiNeural",
 "rate": "+0%",
 "pitch": "+0Hz",
 "volume": "+0%"
 }' \
 --output audio.mp3

지원 언어 목록

curl "http://your-domain/edge-api/languages"

음성 목록 조회

curl "http://your-domain/edge-api/voices/language/ko"

📁 프로젝트 구조

edgetts/
├── backend/ # FastAPI 백엔드
│ ├── app.py # 메인 애플리케이션
│ └── ...
├── frontend/ # React 프론트엔드
│ ├── src/
│ │ ├── App.jsx # 메인 컴포넌트
│ │ ├── main.jsx # 엔트리 포인트
│ │ └── index.css # 스타일
│ ├── dist/ # 빌드된 파일
│ ├── package.json
│ └── vite.config.js
├── samples/ # 음성 샘플 파일
├── tmp/ # 임시 파일
├── .venv/ # Python 가상환경
├── requirements.txt # Python 의존성
├── edgetts.service # Systemd 서비스 파일
├── generate_samples.py # 샘플 생성 스크립트
└── README.md

🎯 API 엔드포인트

음성 합성

정보 조회

관리

🌟 특별한 기능

자동 언어 감지

청크 분할 처리

메모리 최적화

캐시 최적화

🔧 설정 옵션

환경 변수

# 포트 설정 (기본: 3701)
export PORT=3701
# 임시 파일 디렉토리
export TEMP_DIR="/home/purestory/edgetts/tmp"
# 샘플 파일 디렉토리 
export SAMPLE_DIR="/home/purestory/edgetts/samples"

파일 관리 설정

🐛 문제 해결

자주 발생하는 문제

// 브라우저 콘솔에서 실행
localStorage.removeItem('edgetts_history');
localStorage.removeItem('edgetts_stats');
location.reload();

📊 성능 최적화

권장 설정

최적화 팁

🤝 기여하기

📄 라이선스

🙏 감사의 말

📞 지원 및 문의