← Back to Home

API Documentation

Integrate AI content authentication into your applications

Note: API access is available to enterprise customers. Contact us at api@ai-authenticator.com to get started.

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Security: Keep your API keys secure. Never expose them in client-side code or public repositories.

Endpoints

POST /api/v1/verify Requires Auth

Description

Upload an image or video for AI content verification. Returns detailed analysis results.

Request Body

Parameter Type Required Description
file File Yes Image or video file (JPG, PNG, GIF, WEBP, MP4, WEBM)
options Object No Verification options (see below)

Options Object

Parameter Type Default Description
returnCertificate boolean false Include a downloadable certificate in the response
detailedAnalysis boolean false Include detailed breakdown of analysis factors

Example Request

curl -X POST https://api.ai-authenticator.com/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@image.jpg" \
  -F 'options={"returnCertificate": true}'

Response

{
  "success": true,
  "result": {
    "verdict": "AI_GENERATED" | "HUMAN_CREATED",
    "confidence": 0.952,
    "confidencePercentage": "95.2%",
    "analysisFactors": {
      "pixelConsistency": 0.98,
      "metadataSignatures": 0.89,
      "patternAnalysis": 0.94,
      "compressionArtifacts": 0.91
    },
    "processingTime": "12.5s",
    "modelVersion": "v2.1.0"
  },
  "certificate": {
    "id": "CERT-ABC123XYZ",
    "issuedAt": "2025-01-15T10:30:00Z",
    "expiresAt": "2026-01-15T10:30:00Z",
    "downloadUrl": "https://api.ai-authenticator.com/certificates/CERT-ABC123XYZ.pdf"
  }
}
GET /api/v1/verify/:id Requires Auth

Description

Retrieve a previous verification result by ID.

URL Parameters

Parameter Type Description
id string The unique verification ID
GET /api/v1/credits Requires Auth

Description

Check your current credit balance and usage statistics.

Response

{
  "success": true,
  "credits": {
    "available": 150,
    "used": 47,
    "total": 197
  },
  "usage": {
    "thisMonth": 12,
    "lastMonth": 23,
    "averageConfidence": 0.941
  }
}

Response Codes

Code Description
200 Request successful
400 Invalid request
401 Authentication failed
402 Insufficient credits
429 Rate limit exceeded
500 Server error

Supported File Formats

SDKs

npm install @ai-authenticator/sdk
pip install ai-authenticator

Contact

For API access, contact: api@ai-authenticator.com