1:1 Face Verification V2-1

1:1 Face Verification With Liveness Detection (Encrypted string is not required)

POST http://demo.faceid.asia/api/faceid/v2-1/verify

Request Body

Name	Type	Description
apiKey	string	To be assigned by Innov8tif
imageIdCard	object	Front id card image
imageBest	object	Selfie photo

200

{
"imageBestLiveness":
    {
        "probability":2.492201929271687E-7,
        "score":-5.0898823738098145,
        "quality":1.0
    },
"request_id":"TASKAI208003201910300952440191412201",
"result_idcard":
    {
        "confidence":57.86325
    }
}

Input Example in Postman

1KB

OkayFace v2-1.postman_collection.json

Open

OkayDoc v2-1

Interpretation of Result

Key	Value
confidence	Test passes if more than 75 (recommended threshold)
probability	Probability of liveness
score	Linear liveness score: bigger value means more alive
quality	Quality value
error	Error message from the server

• Probability of liveness is a main response of the system.

• The image is accepted as "live" when a probability is bigger than 0.5.

• Linear liveness score can be used for BPCER / APCER tuning.

• The range of score is (ln 1e-7, -ln 1e-7).

• Quality value is a probability of "appropriate image".

• Probability can be lower than 0.5 by the reasons below.

  • Face minimal side is less than 180 pix or distance between eyes is less than 90 pix.

  • Face out-of-plane rotation is bigger than 20 degrees.

  • The distance between face and camera is very small, so the face can be significantly distorted.

  • The luminous power is insufficient.

  • High motion or gaussian blur rate or light shot.

We highly advise to analyze quality value and reject inappropriate images.