Introduction - Aurigin API Docs

Welcome to the Aurigin API

The Aurigin API provides powerful audio analysis capabilities for deepfake detection and voice identification. Our REST API is designed for ease of use while providing enterprise-grade performance and reliability. Two layers of voice security:

Deepfake Detection → Verify if a voice is authentic or AI-generated
Voice Identification (Voice ID) → Confirm who is speaking by matching against enrolled voiceprints

Together, these capabilities create a comprehensive foundation for voice fraud prevention and identity verification.

Base URL

All API requests are made to:

https://api.aurigin.ai/v1

Authentication

All endpoints require authentication via API key in the X-Api-Key header:

curl https://api.aurigin.ai/v1/predict \
  -H "X-Api-Key: YOUR_API_KEY"

Get your API key from the Aurigin Dashboard

Endpoints Overview

Deepfake Detection Endpoints

Endpoint	Processing	Use Case
`/predict`	Synchronous	Direct file analysis
`/file`	Asynchronous	Large files (100MB+)

Voice ID Endpoints

Endpoint	Description	Use Case
`/voiceid/enroll`	Create a voiceprint from a voice sample	Enroll users for identity verification
`/voiceid/verify`	Verify voice identity and authenticity	Authenticate users and prevent fraud

Response Format

All successful API responses return JSON with a consistent structure:

{
  "prediction_id": "pred_abc123def456",
  "global": {
    "confidence": 0.9921,
    "result": "spoofed",
    "reason": null
  },
  "segments": [...],
  "model": "stable-latest",
  "processing_time": 1.23,
  "audio_duration": 10.0,
  "warnings": []
}

Key Fields

prediction_id

string

Unique identifier for tracking this prediction

global

object

Overall prediction with confidence score and classification result

segments

array

Per-segment analysis for timeline-based insights

model

string

Model version used for the prediction

Error Handling

All errors return a consistent error response:

{
  "error": "error_code",
  "message": "Human-readable error message",
  "correlation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Common Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing API key
403	Forbidden - Insufficient permissions
404	Not Found - Resource doesn’t exist
413	Payload Too Large - File exceeds size limit
422	Unprocessable Entity - Invalid file format
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - Server-side issue
503	Service Unavailable - Temporary unavailability

Versioning

The API uses URL versioning. The current stable version is v1:

https://api.aurigin.ai/v1

API versions are maintained for 6 months after deprecation. You’ll receive advance notice of any breaking changes.

Next Steps

Get API Key

Create an API key in the dashboard

Make First Request

Try the Quickstart guide to analyze your first audio file

Explore Endpoints

Browse the Deepfake Detection and Voice ID documentation

​Welcome to the Aurigin API

​Base URL

​Authentication

​Endpoints Overview

​Deepfake Detection Endpoints

​Voice ID Endpoints

​Response Format

​Key Fields

​Error Handling

​Common Error Codes

​Versioning

​Next Steps

Welcome to the Aurigin API

Base URL

Authentication

Endpoints Overview

Deepfake Detection Endpoints

Voice ID Endpoints

Response Format

Key Fields

Error Handling

Common Error Codes

Versioning

Next Steps