Detector24
Back to Model Catalogue
Document Liveness Detector
ImageFraud Detection

Document Liveness Detector

Detect if a document or portrait image was captured live or photographed from a screen

Accuracy
93%
Avg. Speed
15.0s
Per Request
$0.0250
API Name
document-liveness

API Reference

Version
2601
Jan 3, 2026
Avg. Processing
15.0s
Per Request
$0.025
Required Plan
trial

Input Parameters

Vision Language Model for image/video understanding with reasoning

media_typestring

Type of media being sent: 'image' or 'video'. Auto-detected if not specified.

Example:
image
image_urlstring

URL of image to analyze

Example:
https://example.com/image.jpg
base64_imagestring

Base64-encoded image data

video_urlstring

URL of video to analyze

Example:
https://example.com/video.mp4
base64_videostring

Base64-encoded video data

Response Fields

Structured Document Liveness Detector response

responseobject

Structured response from the model

Object Properties:
livenessstring

Whether the document was captured live or from a screen

Possible values:
livecomputer_screenphone_screenother_screen
confidencestring

Confidence level of the detection

Possible values:
lowmediumhigh
indicatorsarray

List of visual indicators detected

thinkingstring

Chain-of-thought reasoning from the model (may be empty)

Complete Example

Request

{
  "model": "document-liveness",
  "image_url": "https://example.com/image.jpg"
}

Response

{
  "inference_id": "inf_abc123def456",
  "model_id": "document_liveness",
  "model_name": "Document Liveness Detector",
  "moderation_type": "image",
  "status": "completed",
  "result": {
    "response": {
      "liveness": "live",
      "confidence": "low",
      "indicators": null
    },
    "thinking": ""
  }
}

Additional Information

Rate Limiting
If we throttle your request, you will receive a 429 HTTP error code along with an error message. You should then retry with an exponential back-off strategy, meaning that you should retry after 4 seconds, then 8 seconds, then 16 seconds, etc.
Supported Formats
gif, jpeg, jpg, png, webp
Maximum File Size
20MB
Tags:documentlivenessscreen-detectionfraudkycvlmai-analysis

Ready to get started?

Integrate Document Liveness Detector into your application today with our easy-to-use API.

Learn more about image moderationBrowse all models