Skip to main content

Documentation Index

Fetch the complete documentation index at: https://sc-docs.deepidv.com/llms.txt

Use this file to discover all available pages before exploring further.

Submit any file — documents, images, audio, or video — and receive a detailed analysis of whether the content is AI-generated, digitally manipulated, or authentic.

​
What is File Deepfake Detection?

File Deepfake Detection is a standalone API service that accepts any supported file and returns a comprehensive analysis of whether its content is AI-generated, digitally manipulated, or authentic. Unlike Live Session Detection — which operates within the context of a verification session — File Deepfake Detection is designed for ad-hoc analysis of documents, images, audio recordings, and video files submitted through any channel. This service is particularly valuable for financial institutions that need to verify the authenticity of supporting documentation submitted during loan applications, account opening, insurance claims, and regulatory filings.

​
Supported File Types

CategoryFormatsTypical Use Cases
DocumentsPDF, DOCXBank statements, pay stubs, tax returns, identity documents, contracts
ImagesJPEG, PNG, TIFF, WEBPIdentity photos, passport scans, proof of address, cheque images
AudioWAV, MP3, M4A, FLACPhone verification recordings, voice authorization captures, call centre recordings
VideoMP4, MOV, WEBMVideo verification recordings, remote notarization sessions, KYC interview recordings
  1. Upload — Your server submits a file via multipart form upload to the analysis endpoint.
  2. Acknowledge — deepidv returns a 202 Accepted response with an analysis_id for tracking.
  3. Analyse — AI models process the file asynchronously. Analysis time varies by file type and size.
  4. Notify — Results are delivered to your configured webhook endpoint when analysis completes.
  5. Retrieve — Optionally poll the results endpoint using the analysis_id if webhook delivery is not configured.

​
Quick Start

curl -X POST https://api.deepidv.com/v1/deepfake-detection/analyze \
  -H "x-api-key: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "file_type=document" \
  -F "callback_url=https://your-server.com/webhooks/deepfake"
A successful submission returns: 
{
  "analysis_id": "df-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "processing",
  "estimated_completion": "2025-01-15T10:45:00.000Z"
}

​
Understanding Results

When analysis completes, the results include the following fields:
FieldTypeDescription
is_ai_generatedbooleanWhether the content is determined to be AI-generated or materially manipulated.
confidence_scorenumber (0–100)Confidence that the content is AI-generated. Higher values indicate greater likelihood of synthetic or manipulated content.
risk_levelstringCategorized risk assessment: low, medium, high, or critical.
detection_detailsarrayArray of specific findings, including the type of manipulation detected and the affected regions or segments of the file.
For the complete response schema and all available fields, refer to the API Reference.

​
File Size Limits

ConstraintLimit
Maximum file size50 MB per file
Rate limit100 requests per minute per API key
Files exceeding 50 MB will be rejected with a 413 Payload Too Large response. For large video files, consider trimming to the relevant segment before submission.

File Analysis Use Cases

Explore banking-specific applications for document and media authenticity verification.

API Reference

View the full API documentation for the file deepfake detection endpoint.