Detector24
Back to Model Catalogue
Face Liveness Detection
VideoFace / People Related

Face Liveness Detection

Anti-spoofing detection for biometric authentication (iBeta Level 1)

Accuracy
98.2%
Avg. Speed
2.1s
Per Request
$0.0240
API Name
face-liveness

API Reference

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

Input Parameters

Face anti-spoofing for biometric authentication (requires 8 frames for temporal analysis)

video_urlstring

URL of video for liveness detection (preferred)

Example:
https://example.com/selfie.mp4
image_urlstring|array

Single video URL or array of 8 frame images

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

Response Fields

Liveness detection result with attack type identification

is_realboolean

True if real face detected (liveness pass)

Example:
true
is_spoofboolean

True if presentation attack detected

Example:
false
real_probabilityfloat

Confidence that face is real (0.0-1.0)

Example:
0.98
confidencefloat

Overall detection confidence (0.0-1.0)

Example:
0.95
attack_typeinteger

Numeric attack type code

Example:
0
attack_type_namestring

Human-readable attack type

Example:
real
attack_type_confidencefloat

Confidence in attack type classification

Example:
0.92

Complete Example

Request

{
  "model": "face-liveness",
  "video_url": "https://example.com/selfie.mp4"
}

Response

{
  "inference_id": "inf_xyz789abc123def456",
  "model_id": "face_liveness",
  "model_name": "Face Liveness Detection",
  "moderation_type": "video",
  "status": "completed",
  "result": {
    "is_real": true,
    "is_spoof": false,
    "real_probability": 0.98,
    "confidence": 0.95,
    "attack_type": 0,
    "attack_type_name": "real",
    "attack_type_confidence": 0.92
  },
  "response_time_ms": 2100,
  "created_at": "2026-02-01T10:54:35Z",
  "completed_at": "2026-02-01T10:54:37Z"
}

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
mp4, mov, avi, webm, mkv
Maximum File Size
50MB
Tags:livenessanti-spoofingbiometricsecurity

Ready to get started?

Integrate Face Liveness Detection into your application today with our easy-to-use API.

Learn more about video moderationBrowse all models