Documentation coming soon...

Detect Deepfakes

POST /api-user/v1/deepfake/detect

Submit 1–50 files for deepfake analysis. Returns immediately with a request_id — poll the GET /status endpoint for results.

Supported File Types

Images

.jpg.jpeg .png.gif .webp

Audio

.mp3.wav .m4a.aac .ogg.flac

Video

.mp4.mov

Documents

.pdf.doc .docx.txt

Size Limits

File Type	Max Size	Max Files
Images	50 MB	50 per request
Audio	100 MB	10 per request
Video	500 MB	5 per request
Documents	5 MB	20 per request

Response Format

Returns HTTP 202 Accepted immediately. Poll using the returned request_id.

{
  "request_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "pending",
  "message": "Poll GET /status/{request_id} for results.",
  "images_count": 3,
  "credits_deducted": 3,
  "credits_remaining": 97,
  "estimated_time_seconds": 30
}

{
"error": "Invalid request",
"message": "No files provided or unsupported format."
}

{
"error": "Authentication failed",
"message": "Invalid or missing X-API-Key header."
}

⚠️ We recommend using the ensemble confidence score rather than individual model results for best accuracy.

Detect Deepfakes 🐍 Python

import requests

url = "https://api.gretchen-ai.com/api-user/v1/deepfake/detect"

headers = {
"X-API-Key": "your-api-key"
}

files = [("files", open("img.jpg", "rb"))]

response = requests.post(
url, headers=headers, files=files
)

print(response.json())