Documentation / Quickstart

Quickstart Guide

Get up and running with AI image detection in under 2 minutes. This guide walks you through getting your API key, installing the SDK, and detecting your first AI-generated image.

Step 1: Get Your API Key

Sign up for free at aiimagedetectorapi.com. Your API key appears in the dashboard immediately — no approval wait.

Your API key will look like: aiid_live_abc123...

Step 2: Install the SDK

Install the official SDK for your language, or use the REST API directly with cURL.

Python
pip install aiimagedetector
Node.js
npm install @aiimagedetector/sdk
Go
go get github.com/aiimagedetector/go-sdk

Step 3: Detect Your First Image

Submit an image for AI detection. The API returns a detection verdict, confidence score, source model attribution, and optional heatmap.

Python
from aiimagedetector import Client

client = Client(api_key="YOUR_API_KEY")

result = client.detect("photo.jpg")

print(f"AI Generated: {result.is_ai_generated}")
print(f"Confidence: {result.confidence}")
print(f"Source Model: {result.source_model}")
print(f"Heatmap URL: {result.heatmap_url}")
cURL
curl -X POST https://api.aiimagedetectorapi.com/v1/detect \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@photo.jpg"

Step 4: Interpret the Response

Every detection response includes a structured JSON payload with the following fields:

  • is_ai_generated (boolean) — True if AI artifacts detected
  • confidence (float 0-1) — Detection confidence score
  • source_model (string) — Identified generator (e.g., "midjourney_v6", "dalle_3", "sdxl")
  • manipulation_regions (array) — Coordinates of detected AI-modified areas
  • heatmap_url (string) — URL to the visual manipulation heatmap
Response Example
{
  "id": "det_8x7k2m",
  "is_ai_generated": true,
  "confidence": 0.971,
  "source_model": "midjourney_v6",
  "source_model_confidence": 0.89,
  "manipulation_regions": [
    {"x": 0, "y": 0, "width": 1024, "height": 1024, "type": "full_synthetic"}
  ],
  "heatmap_url": "https://api.aiimagedetectorapi.com/heatmaps/det_8x7k2m.png",
  "processing_time_ms": 89
}