| ---
|
| title: AI Voice Enhancer API
|
| emoji: 🎙️
|
| colorFrom: purple
|
| colorTo: blue
|
| sdk: gradio
|
| sdk_version: "5.50.0"
|
| app_file: app_wrapper.py
|
| pinned: false
|
| ---
|
|
|
| # 🎙️ AI Voice Enhancer API
|
|
|
| Professional podcast-quality audio enhancement powered by AI. This Space provides a **REST API** for audio processing.
|
|
|
| ## 🚀 Quick Start
|
|
|
| ### For End Users (with Frontend)
|
|
|
| 1. **Download** the frontend from the repository
|
| 2. **Open** `frontend/index.html` in your browser
|
| 3. **Configure** API URL to this Space: `https://YOUR-SPACE-NAME.hf.space`
|
| 4. **Upload** audio and enhance!
|
|
|
| ### For Developers (API Integration)
|
|
|
| ```bash
|
| curl -X POST "https://YOUR-SPACE-NAME.hf.space/enhance" \
|
| -F "file=@input.wav" \
|
| -F "speech_level=80" \
|
| -F "background_level=85" \
|
| -o enhanced.wav
|
| ```
|
|
|
| ## 📡 API Endpoints
|
|
|
| | Endpoint | Method | Description |
|
| |----------|--------|-------------|
|
| | `/` | GET | API information |
|
| | `/health` | GET | Health check |
|
| | `/enhance` | POST | Enhance audio file |
|
| | `/cleanup` | DELETE | Clean temp files |
|
|
|
| ## 🎚️ Parameters
|
|
|
| ### POST /enhance
|
|
|
| - **file**: Audio file (WAV, MP3, M4A, FLAC, OGG, AAC)
|
| - **speech_level**: 0-100 (default: 80) - Voice clarity
|
| - **background_level**: 0-100 (default: 85) - Noise reduction
|
|
|
| ## 🎯 Features
|
|
|
| - ✅ **Noise Suppression**: Facebook Denoiser (DNS) + FFmpeg
|
| - ✅ **Clarity Enhancement**: Multi-stage EQ, compression, de-essing
|
| - ✅ **Loudness Normalization**: EBU R128 standard (-16 LUFS)
|
| - ✅ **Adjustable Processing**: Fine-tune enhancement levels
|
| - ✅ **CPU Optimized**: Runs on free Spaces
|
| - ✅ **CORS Enabled**: Works with any frontend
|
|
|
| ## 🔧 Technical Details
|
|
|
| ### Audio Processing Pipeline:
|
|
|
| 1. **Validation** - Check format, duration, file size
|
| 2. **Noise Suppression** - DNS model or FFmpeg afftdn
|
| 3. **Clarity Enhancement** - EQ, gate, compression, de-esser
|
| 4. **Normalization** - EBU R128 loudness standard
|
|
|
| ### Processing Time:
|
|
|
| - 10-second audio: ~15-30 seconds
|
| - 60-second audio: ~60-120 seconds
|
| - Depends on CPU availability
|
|
|
| ## 📊 Quality
|
|
|
| Targets 80-90% of Adobe Podcast Enhance Speech quality:
|
|
|
| | Feature | Adobe Podcast | This API |
|
| |---------|--------------|----------|
|
| | Noise Removal | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
| | Clarity | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
|
| | Speed | ⭐⭐⭐ | ⭐⭐⭐⭐ |
|
| | Cost | 💰💰💰 | Free ✅ |
|
|
|
| ## 💻 Example: Python Client
|
|
|
| ```python
|
| import requests
|
|
|
| class VoiceEnhancer:
|
| def __init__(self, api_url):
|
| self.api_url = api_url
|
|
|
| def enhance(self, audio_file, speech=80, background=85):
|
| url = f"{self.api_url}/enhance"
|
| files = {"file": open(audio_file, "rb")}
|
| data = {
|
| "speech_level": speech,
|
| "background_level": background
|
| }
|
|
|
| response = requests.post(url, files=files, data=data)
|
|
|
| if response.ok:
|
| return response.content
|
| else:
|
| raise Exception(f"Enhancement failed: {response.text}")
|
|
|
| # Usage
|
| enhancer = VoiceEnhancer("https://YOUR-SPACE-NAME.hf.space")
|
| enhanced_audio = enhancer.enhance("input.wav", speech=80, background=85)
|
|
|
| with open("output.wav", "wb") as f:
|
| f.write(enhanced_audio)
|
| ```
|
|
|
| ## 📝 Limitations
|
|
|
| - **Duration**: Max 60 seconds
|
| - **File Size**: Max 50MB
|
| - **Concurrent Users**: Limited on free tier
|
| - **Processing Speed**: Depends on CPU availability
|
|
|
| ## 🛠️ Tech Stack
|
|
|
| - **API Framework**: FastAPI + Uvicorn
|
| - **Audio Processing**:
|
| - PyTorch + Torchaudio
|
| - Facebook Denoiser (DNS)
|
| - FFmpeg (filters, normalization)
|
| - **ML Model**: DNS64 (pretrained)
|
|
|
| ## 📦 Deployment
|
|
|
| This Space runs:
|
| - FastAPI server on port 7860
|
| - Gradio info page on port 7861 (this page)
|
|
|
| The actual audio processing happens via the FastAPI endpoints.
|
|
|
| ## 🔒 Privacy
|
|
|
| - No data stored permanently
|
| - Temporary files auto-deleted after 30 minutes
|
| - No analytics or tracking
|
| - Processes on-server (no external APIs)
|
|
|
| ## 📄 License
|
|
|
| MIT License - Free to use, modify, and distribute.
|
|
|
| ## 🙏 Acknowledgments
|
|
|
| - **Facebook AI**: For Denoiser library
|
| - **FFmpeg**: For robust audio tools
|
| - **Hugging Face**: For free hosting
|
|
|
| ---
|
|
|
| **Repository**: [GitHub Link Here]
|
| **Frontend**: Download from repository
|
| **Support**: Open an issue on GitHub
|
|
|
