ASC API Documentation

Overview

The ASC (AI Song Checker) API provides programmatic access to our ASC Engine engine. It uses 82+ forensic audio signals and Bayesian scoring to detect AI-generated music from Suno, Udio, Riffusion, ElevenLabs, Stable Audio, MusicGen, and Mureka.

All endpoints use JSON for requests and responses. Audio feature extraction can be done client-side or server-side depending on your use case.

How It Works

1. Send audio features (or a URL) to the API
2. Our scoring engine analyzes 82+ forensic signals
3. Receive a verdict (AI / Human), confidence level, score, and detailed reasons

Authentication

All requests require an API key passed in the X-API-Key header. Get your key from the Dashboard (Pro plan required).

Header Format

X-API-Key: asc_your_api_key_here

Quick Start

cURL

curl -X POST "https://api.aisongchecker.pro/v1?action=analyze" \
  -H "X-API-Key: asc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "audio_url": "https://example.com/track.mp3"
  }'Copy

Python

import requests

response = requests.post(
    "https://api.aisongchecker.pro/v1?action=analyze",
    headers={
        "X-API-Key": "asc_your_api_key",
        "Content-Type": "application/json"
    },
    json={"audio_url": "https://example.com/track.mp3"}
)

result = response.json()
print(f"Verdict: {result['prediction']} — Score: {result['ai_score']}%")Copy

JavaScript

const response = await fetch(
  "https://api.aisongchecker.pro/v1?action=analyze",
  {
    method: "POST",
    headers: {
      "X-API-Key": "asc_your_api_key",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      audio_url: "https://example.com/track.mp3"
    })
  }
);

const result = await response.json();
console.log(`${result.prediction} — ${result.ai_score}%`);Copy

Endpoints

{
  "prediction": "ai",
  "ai_score": 87,
  "confidence_level": "high",
  "reasons": [
    "32kHz resampling artifacts detected",
    "Harmonic instability pattern recognized",
    "Transformer attention patterns identified"
  ],
  "engine": "v8.3",
  "analysis_time_ms": 2341
}Copy

{
  "error": "invalid_audio_format",
  "message": "Audio format not supported. Accepted: mp3, wav, ogg, flac, m4a",
  "status": 400
}Copy

Webhooks

Register a webhook URL to receive real-time notifications when asynchronous analyses complete.

{
  "url": "https://your-server.com/asc-webhook",
  "events": ["analysis.complete", "certificate.ready"]
}Copy

{
  "event": "analysis.complete",
  "job_id": "job_abc123def456",
  "prediction": "ai",
  "ai_score": 91,
  "confidence_level": "very_high",
  "timestamp": "2026-03-30T14:25:00Z"
}Copy

Rate Limits

Limits are enforced per API key and reset daily at midnight UTC.

Rate Limit Headers

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9658
X-RateLimit-Reset: 1711929600

When you exceed your limit, the API returns 429 Too Many Requests with a Retry-After header.

Error Codes

All errors return a consistent JSON structure with error, message, and status fields.

Error Response Example

{
  "error": "unauthorized",
  "message": "Invalid or expired API key",
  "status": 401
}Copy

SDKs

Official client libraries are coming soon. In the meantime, the API is simple to integrate with any HTTP client — see the Quick Start examples above for cURL, Python, and JavaScript.

Changelog

v1.0 — March 2026

Initial Release

• Audio analysis endpoint with ASC Engine v8.3 engine (82+ forensic signals)
• AI generation prediction with confidence scoring
• C2PA and SynthID watermark detection
• Asynchronous URL analysis with job management
• Authenticity certificate generation and verification
• Webhook support for real-time notifications
• Quota and usage tracking
• Pro and Enterprise tiers

Support

Need help integrating the API?

• Email: contact@nthg.fr
• Dashboard: Manage your API key and view usage
• Status: Use the /status endpoint to check API health