1:1 Face Verification V3-1

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

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

Request Body

Name	Type	Description
apiKey	string	To be assigned by Innov8tif
imageIdCard	object	Front id card image
imageBest	string	Encrypted string for liveness face retrieved via liveness SDK

200 Response without liveness checking

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

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.