Skip to main content

​
Welcome to the Aurigin API

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

​
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

​
Prediction Endpoints

EndpointFile SizeProcessingUse Case
/predict< 5 MBSynchronousQuick analysis
/predict/large-file5-100 MBSynchronousMedium files
/file100 MB+AsynchronousLarge files

​
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

CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
404Not Found - Resource doesn’t exist
413Payload Too Large - File exceeds size limit
422Unprocessable Entity - Invalid file format
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Server-side issue
503Service 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

1

Get API Key

Create an API key in the dashboard
2

Make First Request

Try the Quickstart guide to analyze your first audio file
3

Explore Endpoints

Browse the Prediction API documentation