Skip to main content
POST
/
v1
/
deepfake-detection
/
analyze
Analyze File
curl --request POST \
  --url https://api.deepidv.com/v1/deepfake-detection/analyze
{
  "id": "da_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "file_name": "passport_scan.pdf",
  "file_type": "document",
  "external_id": "doc-review-789",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_completion_seconds": 15
}

POST /v1/deepfake-detection/analyze
Submits a file for asynchronous deepfake and AI-generation analysis. Supports documents, images, audio, and video files. Returns an analysis ID for polling or use a callback URL for webhook notification.

​
Request

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key
Content-TypeYesmultipart/form-data

​
Body parameters

ParameterTypeRequiredDescription
filefileYesThe file to analyze. Max size: 50MB
file_typestringNoOverride auto-detection. Values: document, image, audio, video
callback_urlstringNoHTTPS URL for webhook delivery of results when analysis completes
external_idstringNoYour internal reference ID for this analysis

​
Example request

curl -X POST https://api.deepidv.com/v1/deepfake-detection/analyze \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@passport_scan.pdf" \
  -F "file_type=document" \
  -F "callback_url=https://yourapp.com/webhooks/deepfake" \
  -F "external_id=doc-review-789"

​
Response

​
202 — Accepted

FieldTypeDescription
idstringUnique analysis identifier
statusstringAlways processing on creation
file_namestringOriginal filename
file_typestringDetected or specified file type
external_idstringYour external ID (if provided)
created_atstringISO 8601 timestamp
estimated_completion_secondsnumberEstimated processing time in seconds

​
Error responses

StatusDescription
400 Bad RequestMissing file or invalid parameters
401 UnauthorizedMissing or invalid API key
413 Payload Too LargeFile exceeds 50MB limit
415 Unsupported Media TypeFile type not supported
429 Too Many RequestsRate limit exceeded
{
  "id": "da_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "file_name": "passport_scan.pdf",
  "file_type": "document",
  "external_id": "doc-review-789",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_completion_seconds": 15
}