Documentation

API Documentation

Everything you need to integrate ProofLayer AI into your application.

Getting Started

Quick start guide for the ProofLayer API

Authentication

API key management and auth methods

Verify Endpoint

Core endpoint for content verification

Response Format

Understanding trust scores and analysis

Rate Limits

Plan-based rate limits and quotas

BYOK Setup

Configure your own AI provider keys

Getting Started

ProofLayer AI provides a REST API for verifying AI-generated content. Here's a quick example:

curl -X POST https://api.prooflayer.ai/api/verify \
  -H "Authorization: Bearer pl_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "contentType": "text",
    "content": "Text to analyze for AI generation..."
  }'

The API returns a trust score (0-100), AI probability, model fingerprint, and detailed analysis.

Authentication

All API requests require authentication via an API key in the Authorization header:

Authorization: Bearer pl_live_your_api_key

Creating API Keys

Generate API keys from your Dashboard → API Keys page. Keys are prefixed with pl_live_ for production and pl_test_ for sandbox.

Verify Endpoint

POST/api/verify

Request Body

{
  "contentType": "image" | "audio" | "video" | "text",
  "content": "base64_encoded_file_or_raw_text",
  "mimeType": "image/jpeg",           // required for files
  "provider": "openai" | "anthropic" | "gemini",  // optional
  "fileName": "photo.jpg",            // optional
  "fileSize": 1024000                  // optional, bytes
}

Headers

Header	Required	Description
Authorization	Yes	Bearer token (API key or session)
Content-Type	Yes	application/json
X-Provider	No	Override AI provider selection

Response Format

{
  "id": "scan_uuid",
  "trustScore": 85.5,           // 0-100, higher = more authentic
  "aiProbability": 14.5,        // 0-100, probability of AI generation
  "isAiGenerated": false,       // boolean threshold at 70%
  "confidence": 92,             // 0-100, model confidence
  "modelFingerprint": null,     // e.g., "GPT-4", "DALL-E 3"
  "manipulationType": null,     // e.g., "full_generation", "face_swap"
  "detailedAnalysis": {
    "reasoning": "Detailed explanation...",
    "textualPatterns": ["signal1", "signal2"]
  },
  "provider": "openai",
  "isByok": false,
  "processingTimeMs": 1250,
  "contentType": "text",
  "createdAt": "2026-01-15T10:30:00Z"
}

Rate Limits

Plan	Requests/min	Scans/month	BYOK Scans/month
Starter	20	500	2,500
Pro	100	5,000	25,000
Growth	500	50,000	250,000
Enterprise	2,000	500,000	Unlimited

Rate-limited responses return 429 Too Many Requests with a Retry-After header.

BYOK Setup

Bring Your Own Key (BYOK) lets you use your own API keys from OpenAI, Anthropic, or Google Gemini.

Go to Dashboard → BYOK Providers
Click "Add Provider Key" and select your provider
Enter your API key (encrypted at rest with AES-256-GCM)
Test the key to verify it works
Use the X-Provider header or provider body param to select your provider

BYOK scans charge only the platform fee ($$0.001-$0.003/scan) instead of counting against your platform scan quota.