Developer API

Integrate our AI-powered authenticity analysis directly into your applications.

Getting Started

Our API provides direct access to the same analysis engine used by DeepfakeArmy.com. You can submit images for analysis and receive a detailed JSON response with authenticity scores and descriptions.

Authentication

API Key

All API requests must be authenticated using an API key. You must include your key in the X-API-Key header of every request.

Header Example:

X-API-Key: your_secret_api_key_here

Currently, API keys are provisioned manually. Please contact our team to request an API key and discuss pricing.

Endpoints

Analyze Image

Submit a base64-encoded image for a full authenticity analysis.

POST

/api/v1/analyze

Request Body

{
  "filename": "string",
  "photoDataUri": "string (data:image/...;base64,...)"
}

Example Request (cURL)

curl -X POST https://www.deepfakearmy.com/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "filename": "my-image.jpg",
    "photoDataUri": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
  }'

Response Structure

Analysis Response

Successful requests return a JSON object containing the full analysis.

{
  "title": "Sunlit Mountain Peak Reflected in Clear Alpine Lake",
  "description": "A landscape photo of a mountain reflected in a lake...",
  "analysis": {
    "overallAIScore": 0.05,
    "faceManipulationScore": 0,
    "diffusionModelScores": {
      "imagen": 0,
      "stableDiffusion": 0,
      // ... more models
    },
    "ganModelScores": {
      "styleGan": 0,
      "otherGan": 0
    },
    "textAnalysis": {
      "containsText": false,
      "isLegible": true,
      "legibilityScore": 0,
      "textDescription": "No text present."
    },
    "explanation": "This image exhibits natural lighting, complex textures..."
  }
}

Try it in the Browser