
Detect screen capture fraud and document replay attacks. Verify if ID photos are captured live or photographed from screens. Prevent identity fraud.
The Bynn Document Liveness Detector determines whether a document or portrait image was captured directly from the physical document (live) or photographed from a screen display. This model is critical for KYC/KYB workflows where document authenticity verification is essential.
Identity fraud has evolved beyond simple document forgery. Fraudsters now photograph legitimate documents displayed on screens—using images found online, stolen from data breaches, or obtained through social engineering. This "screen capture" attack bypasses traditional document verification because the underlying document may be genuine, even though the submission is fraudulent.
The technique is devastatingly simple: find or steal someone's ID photo, display it on a phone or monitor, and photograph it for submission. Without liveness detection, verification systems cannot distinguish this attack from legitimate document capture. Financial institutions, cryptocurrency exchanges, and any platform requiring identity verification face millions in fraud losses from this single attack vector.
When provided with an image of a document, the detector analyzes visual characteristics to identify signs of screen capture versus live document photography. The model looks for specific indicators like screen bezels, reflections, pixel patterns, and unnatural lighting that reveal when a document has been photographed from a digital display.
Achieving 93.0% accuracy, the model uses Bynn's Visual Language Model technology trained on document forensics to detect subtle visual artifacts that indicate screen capture fraud.
The model analyzes multiple visual indicators to determine document liveness:
The API returns a structured JSON response containing:
| Classification | Description |
|---|---|
| live | Photographed directly from the physical document |
| computer_screen | Photographed from a computer monitor or laptop screen |
| phone_screen | Photographed from a phone or tablet screen |
| other_screen | Photographed from TV, projector, or other display type |
| Metric | Value |
|---|---|
| Detection Accuracy | 93.0% |
| Average Response Time | 15,000ms |
| Max File Size | 20MB |
| Supported Formats | GIF, JPEG, JPG, PNG, WebP |
Important Considerations:
This model provides probability-based classifications, not definitive fraud determinations.
Best Practice: Use liveness detection as part of a comprehensive document verification workflow that includes multiple fraud detection signals.
Vision Language Model for image/video understanding with reasoning
media_typestringType of media being sent: 'image' or 'video'. Auto-detected if not specified.
imageimage_urlstringURL of image to analyze
https://example.com/image.jpgbase64_imagestringBase64-encoded image data
video_urlstringURL of video to analyze
https://example.com/video.mp4base64_videostringBase64-encoded video data
Structured Document Liveness Detector response
responseobjectStructured response from the model
livenessstringWhether the document was captured live or from a screen
livecomputer_screenphone_screenother_screenconfidencestringConfidence level of the detection
lowmediumhighindicatorsarrayList of visual indicators detected
thinkingstringChain-of-thought reasoning from the model (may be empty)
{
"model": "document-liveness",
"image_url": "https://example.com/image.jpg"
}{
"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": ""
}
}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.Integrate Document Liveness Detector into your application today with our easy-to-use API.