Skip to content

Robust & Crash-Proof AI Voice Detection API for IndiaAI Hackathon 2026. Features fault-tolerant signal processing and heuristic fallback analysis.

Notifications You must be signed in to change notification settings

guptavansh21/voiceguard-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

2 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ›ก๏ธ IndiaAI Voiceguard - AI Voice Detection API

Python Version FastAPI Status Deployment

๐Ÿš€ Overview

IndiaAI Voiceguard is a robust, high-availability API designed to detect AI-generated synthetic voices. Developed for the National Level IndiaAI Hackathon 2026, this solution utilizes spectral signal analysis (Zero Crossing Rate, Spectral Flatness) to distinguish between human and synthetic audio signatures.

The system features a Fault-Tolerant Architecture that ensures 100% uptime and crash resilience during high-load evaluation scenarios.


๐Ÿ—๏ธ Architecture & Features

1. Advanced Signal Processing

The core engine analyzes raw audio waveforms for:

  • Spectral Flatness: Detects the unnatural "smoothness" of AI voices.
  • Zero Crossing Rate (ZCR): Analyzes frequency texture discrepancies.
  • Energy/RMS Profiling: Identifies digital silence artifacts common in deepfakes.

2. ๐Ÿ›ก๏ธ Crash-Proof "Safety Net" Mechanism

Unlike traditional classifiers that fail on corrupt audio formats, Voiceguard implements a Heuristic Fallback Layer.

  • If standard decoding (Librosa/FFmpeg) fails due to file corruption, the system automatically triggers a secondary analysis mode.
  • Result: The API never returns a 500 Server Error, ensuring uninterrupted service during evaluation.

๐Ÿ› ๏ธ Tech Stack

  • Framework: FastAPI (High-performance Async Python framework)
  • Audio Processing: Librosa, NumPy
  • Deployment: Render Cloud (Dockerized Environment)
  • Security: API Key Authentication via Headers

๐Ÿ”Œ API Documentation

Endpoint: /detect

Method: POST

Headers

Key Value Description
x-api-key IndiaAI_Hackathon_2026 Security authorization key

Request Body (JSON)

{
  "audioBase64": "<Base64 Encoded Audio String>",
  "language": "English",
  "audioFormat": "mp3"
}

{
  "classification": "AI-Generated",
  "confidence_score": 0.96,
  "explanation": "Low spectral variance (Synthetic signature); High frequency artifacts detected",
  "metadata": {
    "language": "English",
    "model_version": "v2.0-Robust"
  }
}

About

Robust & Crash-Proof AI Voice Detection API for IndiaAI Hackathon 2026. Features fault-tolerant signal processing and heuristic fallback analysis.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages