OkayFace

ImagesGeneral Image Requirements

Below are the requirements for size and quality of document images captured by any device, which are necessary for accurate return of results by OkayFace:

Maximum File Size:

  • imageIdCard (ID Card Image) = 3MB

  • imageBest (selfie) = 3MB

Minimum Resolution:

  • 450px x 450px

It is recommended to use uncompressed formats. If it’s not possible, then use compress image with the highest quality to make sure that the API detection is accurate.

Capture Requirements

To Avoid:

  1. Blurry or motion blur selfie image that will decrease the accuracy of the API.

  2. Overly compressed image that will decrease the accuracy of the API.

  3. Selfie that is taken in landscape mode that will cause detection error.

  4. Environment that is too bright or too dark that cause API fail to pick up the selfie's facial features.

  5. Multiple faces in the background of the selfie.

  6. Facial position that is too near or too far from the selfie image.

To Do:

  1. Facing straight to the camera to ensure the API detection is able to detect the facial features accurately.

  2. Retain a portion of margin surrounding the selfie image to prevent API fail to detect face.

  3. Make sure the selfie's head is within the picture frame.

All of the following mentioned above will positively/negatively affect the accuracy of the API.

Checking
Error Code
Sample Image

Selfie Occlusion Check

FACE_IS_OCCLUDED

ID Occlusions Check

FACE_IS_OCCLUDED

Face Detection

FACE_NOT_FOUND

Multiple Face Detection

TOO_MANY_FACES

Face Distance Check

FACE_ANGLE_TOO_LARGE

Face Distance Check

FACE_TOO_SMALL

Eye Closed Detection

EYES_CLOSED

Examples of Correct ID and Selfie Images:

ID Image
Selfie Image

Examples of the correct samples are references to guide the user to take a good selfie without facing errors or getting low accuracy for the API detection.

Last updated