Face Passive Liveness Detection

Tells from one image whether a face is a live person or a spoof, such as a printed photo, a realistic mask, a screen or a video replay; active liveness adds on-device challenges on top.

POST/v3/store/ekyc/face-passive-livenessTry it

• Price0.3 ICper request
• Served6Mcalls

• v1.8
• Active

Input

file

selfie.jpg

OutputPOST /v3/store/ekyc/face-passive-liveness

filename

S__5333002.jpg

predict

SPOOF

score

0.9999989633974822

darkness

0.51

data

SPOOF: 0.9999990463256836 REAL: 9.35794162160164e-7

normalized

SPOOF: 0.9999989633974822 REAL: 0.0000010366025178232263

status_code

200

duration

0.35393

message

SUCCESS

Every field, under Response

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/face-passive-liveness \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@selfie.jpg"

Response

200OK. The fields are explained under Response.

{
    "filename": "S__5333002.jpg",
    "predict": "SPOOF",
    "score": 0.9999989633974822,
    "darkness": 0.51,
    "data": {
        "SPOOF": 0.9999990463256836,
        "REAL": 9.35794162160164e-7
    },
    "normalized": {
        "SPOOF": 0.9999989633974822,
        "REAL": 1.0366025178232263e-6
    },
    "status_code": 200,
    "duration": 0.35393,
    "message": "SUCCESS"
}

Request

multipart/form-data, one image per request. Both endpoints cost 0.3 IC per request.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

filefilerequired

The face image. JPEG, PNG, HEIC or HEIF, up to 10 MB.

Endpoint	Returns
/v3/store/ekyc/face-passive-liveness	The verdict, iBeta Level 1 certified
/v3/store/ekyc/face-passive-liveness/v1p10	The same, from the v1p10 model

The legacy paths /anti_face_spoofing, /api/v2/fas, /face-spoofing, /passive-face-liveness-detection and /v1p10/facial_anti_spoofing answer at the same price.

Response

predictstring

REAL or SPOOF, from the normalised score

scorenumber

The normalised score of the prediction, 0 to 1

normalizeddata

The REAL and SPOOF scores after and before normalisation

normalized.REALnumber

normalized.SPOOFnumber

darknessnumber

How dark the image is, 0 to 1

filenamedurationstatus_codemessage

The file name; seconds; 200 and SUCCESS on success

Details

Measured

Measure	Result
Correct verdicts, 7,680 tests	99.43%
Presentation attack detection	iBeta Level 1, the confirmation letter (PDF)

Limits

• One face per image.

Data handling

Images are processed in memory and not kept after the response. The service is GDPR and PDPA compliant.