post https://api.verihubs.com/v1/face/compare
This method helps you to compare face between 2 images
The following table describes the image option to be used as input.
Image scenario consists of Person A to J. Person is described in the last character: _A means person A, _B means person B, up until _J means person_J. Besides, image scenario consists of number of face in single image 1-9. Number of Face is described in the last character, which are _1 means 1 face in photo, _2 means 2 face in photo.
| Images | Description |
|---|---|
| IMAGE_EXCEED_LIMIT | Photo with size > 5MiB |
| NO_FACE_PHOTO | Photo with no face detected |
| LIVE_PERSON_A_N | Photo of Live Person (A) |
| LIVE_PERSON_M_A_N | Photo of Live Person (A) wearing Mask |
| LIVE_PERSON_V_A_N | Photo of Live Person (A) wearing Veil |
| LIVE_PERSON_S_A_N | Photo of Live Person (A) wearing Sunglasses |
| LIVE_PERSON_MV_A_N | Photo of Live Person (A) wearing Mask, Veil |
| LIVE_PERSON_MS_A_N | Photo of Live Person (A) wearing Mask, Sunglasses |
| LIVE_PERSON_VS_A_N | Photo of Live Person (A) wearing Veil, Sunglasses |
| LIVE_PERSON_MVS_A_N | Photo of Live Person (A) wearing Mask, Veil, Sunglasses |
| LIVE_PERSON_BLUR_A_N | Photo of Live Person (A) with blur condition |
| LIVE_PERSON_DARK_A_N | Photo of Live Person (A) with dark condition |
| LIVE_PERSON_BLURDARK_A_N | Photo of Live Person (A) with blur and dark condition |
| LIVE_PERSON_BLUR_M_A_N | Photo of Live Person (A) wearing Mask, with blur condition |
| LIVE_PERSON_BLUR_V_A_N | Photo of Live Person (A) wearing Veil, with blur condition |
| LIVE_PERSON_BLUR_S_A_N | Photo of Live Person (A) wearing Sunglasses, with blur condition |
| LIVE_PERSON_BLUR_MV_A_N | Photo of Live Person (A) wearing Mask, Veil, with blur condition |
| LIVE_PERSON_BLUR_MS_A_N | Photo of Live Person (A) wearing Mask, Sunglasses with blur condition |
| LIVE_PERSON_BLUR_VS_A_N | Photo of Live Person (A) wearing Veil, Sunglasses, with blur condition |
| LIVE_PERSON_BLUR_MVS_A_N | Photo of Live Person (A) wearing Mask, Veil, Sunglasses, with blur condition |
| LIVE_PERSON_DARK_M_A_N | Photo of Live Person (A) wearing Mask, with dark condition |
| LIVE_PERSON_DARK_V_A_N | Photo of Live Person (A) wearing Veil, with dark condition |
| LIVE_PERSON_DARK_S_A_N | Photo of Live Person (A) wearing Sunglasses, with dark condition |
| LIVE_PERSON_DARK_MV_A_N | Photo of Live Person (A) wearing Mask, Veil, with dark condition |
| LIVE_PERSON_DARK_MS_A_N | Photo of Live Person (A) wearing Mask, Sunglasses, with dark condition |
| LIVE_PERSON_DARK_VS_A_N | Photo of Live Person (A) wearing Veil, Sunglasses with blur and dark condition |
| LIVE_PERSON_DARK_MVS_A_N | Photo of Live Person (A) wearing Mask, Veil, Sunglasses, with dark condition |
| LIVE_PERSON_BLURDARK_M_A_N | Photo of Live Person (A) wearing Mask, with blur and dark condition |
| LIVE_PERSON_BLURDARK_V_A_N | Photo of Live Person (A) wearing Veil, with blur and dark condition |
| LIVE_PERSON_BLURDARK_S_A_N | Photo of Live Person (A) wearing Sunglasses, with blur and dark condition |
| LIVE_PERSON_BLURDARK_MV_A_N | Photo of Live Person (A) wearing Mask, Veil, with blur and dark condition |
| LIVE_PERSON_BLURDARK_MS_A_N | Photo of Live Person (A) wearing Mask, Sunglasses, with blur and dark condition |
| LIVE_PERSON_BLURDARK_VS_A_N | Photo of Live Person (A) wearing Veil, Sunglasses with blur and blur and dark condition |
| LIVE_PERSON_BLURDARK_MVS_A_N | Photo of Live Person (A) wearing Mask, Veil, Sunglasses, with blur and dark condition |
| SPOOF_PERSON_A_N | Photo of Spoof Person (A) |
| SPOOF_PERSON_M_A_N | Photo of Spoof Person (A) wearing Mask |
| SPOOF_PERSON_V_A_N | Photo of Spoof Person (A) wearing Veil |
| SPOOF_PERSON_S_A_N | Photo of Spoof Person (A) wearing Sunglasses |
| SPOOF_PERSON_MV_A_N | Photo of Spoof Person (A) wearing Mask, Veil |
| SPOOF_PERSON_MS_A_N | Photo of Spoof Person (A) wearing Mask, Sunglasses |
| SPOOF_PERSON_VS_A_N | Photo of Spoof Person (A) wearing Veil, Sunglasses |
| SPOOF_PERSON_MVS_A_N | Photo of Spoof Person (A) wearing Mask, Veil, Sunglasses |
| SPOOF_PERSON_BLUR_A_N | Photo of Spoof Person (A) with blur condition |
| SPOOF_PERSON_DARK_A_N | Photo of Spoof Person (A) with dark condition |
| SPOOF_PERSON_BLURDARK_A_N | Photo of Spoof Person (A) with blur and dark condition |
| SPOOF_PERSON_GRAY_A_N | Photo of Spoof Person (A) in grayscale image |
| SPOOF_PERSON_GRAY_M_A_N | Photo of Spoof Person (A) in grayscale image wearing Mask |
| SPOOF_PERSON_GRAY_V_A_N | Photo of Spoof Person (A) in grayscale image wearing Veil |
| SPOOF_PERSON_GRAY_S_A_N | Photo of Spoof Person (A) in grayscale image wearing Sunglasses |
| SPOOF_PERSON_GRAY_MV_A_N | Photo of Spoof Person (A) in grayscale image wearing Mask, Veil |
| SPOOF_PERSON_GRAY_MS_A_N | Photo of Spoof Person (A) in grayscale image wearing Mask, Sunglasses |
| SPOOF_PERSON_GRAY_VS_A_N | Photo of Spoof Person (A) in grayscale image wearing Veil, Sunglasses |
| SPOOF_PERSON_GRAY_MVS_A_N | Photo of Spoof Person (A) in grayscale image wearing Mask, Veil, Sunglasses |
| SPOOF_PERSON_GRAYBLUR_A_N | Photo of Spoof Person (A) in grayscale image with blur condition |
| SPOOF_PERSON_GRAYDARK_A_N | Photo of Spoof Person (A) in grayscale image with dark condition |
| SPOOF_PERSON_GRAYBLURDARK_A_N | Photo of Spoof Person (A) in grayscale image with blur and dark condition |
| SPOOF_PERSON_BLUR_M_A_N | Photo of Spoof Person (A) wearing Mask, with blur condition |
| SPOOF_PERSON_BLUR_V_A_N | Photo of Spoof Person (A) wearing Veil, with blur condition |
| SPOOF_PERSON_BLUR_S_A_N | Photo of Spoof Person (A) wearing Sunglasses, with blur condition |
| SPOOF_PERSON_BLUR_MV_A_N | Photo of Spoof Person (A) wearing Mask, Veil, with blur condition |
| SPOOF_PERSON_BLUR_MS_A_N | Photo of Spoof Person (A) wearing Mask, Sunglasses with blur condition |
| SPOOF_PERSON_BLUR_VS_A_N | Photo of Spoof Person (A) wearing Veil, Sunglasses, with blur condition |
| SPOOF_PERSON_BLUR_MVS_A_N | Photo of Spoof Person (A) wearing Mask, Veil, Sunglasses, with blur condition |
| SPOOF_PERSON_DARK_M_A_N | Photo of Spoof Person (A) wearing Mask, with dark condition |
| SPOOF_PERSON_DARK_V_A_N | Photo of Spoof Person (A) wearing Veil, with dark condition |
| SPOOF_PERSON_DARK_S_A_N | Photo of Spoof Person (A) wearing Sunglasses, with dark condition |
| SPOOF_PERSON_DARK_MV_A_N | Photo of Spoof Person (A) wearing Mask, Veil, with dark condition |
| SPOOF_PERSON_DARK_MS_A_N | Photo of Spoof Person (A) wearing Mask, Sunglasses, with dark condition |
| SPOOF_PERSON_DARK_VS_A_N | Photo of Spoof Person (A) wearing Veil, Sunglasses with blur and dark condition |
| SPOOF_PERSON_DARK_MVS_A_N | Photo of Spoof Person (A) wearing Mask, Veil, Sunglasses, with dark condition |
| SPOOF_PERSON_BLURDARK_M_A_N | Photo of Spoof Person (A) wearing Mask, with blur and dark condition |
| SPOOF_PERSON_BLURDARK_V_A_N | Photo of Spoof Person (A) wearing Veil, with blur and dark condition |
| SPOOF_PERSON_BLURDARK_S_A_N | Photo of Spoof Person (A) wearing Sunglasses, with blur and dark condition |
| SPOOF_PERSON_BLURDARK_MV_A_N | Photo of Spoof Person (A) wearing Mask, Veil, with blur and dark condition |
| SPOOF_PERSON_BLURDARK_MS_A_N | Photo of Spoof Person (A) wearing Mask, Sunglasses, with blur and dark condition |
| SPOOF_PERSON_BLURDARK_VS_A_N | Photo of Spoof Person (A) wearing Veil, Sunglasses with blur and blur and dark condition |
| SPOOF_PERSON_BLURDARK_MVS_A_N | Photo of Spoof Person (A) wearing Mask, Veil, Sunglasses, with blur and dark condition |
| SPOOF_PERSON_GRAYBLUR_M_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, with blur condition |
| SPOOF_PERSON_GRAYBLUR_V_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, with blur condition |
| SPOOF_PERSON_GRAYBLUR_S_A_N | Photo of Spoof Person (A) in grayscale image, wearing Sunglasses, with blur condition |
| SPOOF_PERSON_GRAYBLUR_MV_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, with blur condition |
| SPOOF_PERSON_GRAYBLUR_MS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Sunglasses, with blur condition |
| SPOOF_PERSON_GRAYBLUR_VS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, Sunglasses, with blur condition |
| SPOOF_PERSON_GRAYBLUR_MVS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, Sunglasses with blur condition |
| SPOOF_PERSON_GRAYDARK_M_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, with dark condition |
| SPOOF_PERSON_GRAYDARK_V_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, with dark condition |
| SPOOF_PERSON_GRAYDARK_S_A_N | Photo of Spoof Person (A) in grayscale image, wearing Sunglasses, with dark condition |
| SPOOF_PERSON_GRAYDARK_MV_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, with dark condition |
| SPOOF_PERSON_GRAYDARK_MS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Sunglasses, with dark condition |
| SPOOF_PERSON_GRAYDARK_VS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, Sunglasses, with dark condition |
| SPOOF_PERSON_GRAYDARK_MVS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, Sunglasses with dark condition |
| SPOOF_PERSON_GRAYBLURDARK_M_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_V_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_S_A_N | Photo of Spoof Person (A) in grayscale image, wearing Sunglasses, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_MV_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_MS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Sunglasses, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_VS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Veil, Sunglasses, with blur and dark condition |
| SPOOF_PERSON_GRAYBLURDARK_MVS_A_N | Photo of Spoof Person (A) in grayscale image, wearing Mask, Veil, Sunglasses with blur and dark condition |
The following table describes the similarity between the images. Only the same photo could give 100% similarity.
| SIMILARITY | A | B | C | D | E | F | G | H | I | J |
|---|---|---|---|---|---|---|---|---|---|---|
| A | SAME PERSON | |||||||||
| B | SIMILAR | SAME PERSON | ||||||||
| C | SIMILAR | SIMILAR | SAME PERSON | |||||||
| D | SIMILAR | SIMILAR | DIFFERENT | SAME PERSON | ||||||
| E | DIFFERENT | SIMILAR | DIFFERENT | SIMILAR | SAME PERSON | |||||
| F | DIFFERENT | DIFFERENT | DIFFERENT | DIFFERENT | DIFFERENT | SAME PERSON | ||||
| G | DIFFERENT | DIFFERENT | DIFFERENT | DIFFERENT | SIMILAR | SIMILAR | SAME PERSON | |||
| H | DIFFERENT | DIFFERENT | DIFFERENT | DIFFERENT | SIMILAR | SIMILAR | DIFFERENT | SAME PERSON | ||
| I | DIFFERENT | DIFFERENT | DIFFERENT | SIMILAR | DIFFERENT | SIMILAR | SIMILAR | DIFFERENT | SAME PERSON | |
| J | DIFFERENT | DIFFERENT | DIFFERENT | DIFFERENT | SIMILAR | SIMILAR | SIMILAR | SIMILAR | SIMILAR | SAME PERSON |
You will receive a response consists of message and an error code if the request fails to process. The following is a list of error codes.
| Error code | Description |
|---|---|
| INVALID_PAYLOAD | no value in payload or empty string more than 1 |
| INVALID_PAYLOAD_IMAGE_1_SIZE | invalid payload image 1 size too large |
| INVALID_PAYLOAD_IMAGE_2_SIZE | invalid payload image 2 size too large |
| MISSING_PAYLOAD_IMAGE_1 | missing payload image 1 |
| MISSING_PAYLOAD_IMAGE_2 | missing payload image 2 |
| INVALID_PAYLOAD_IMAGE_1_MISSING | image 1 empty string |
| INVALID_PAYLOAD_IMAGE_2_MISSING | image 2 empty string |
| INVALID_PAYLOAD_THRESHOLD_MISSING | threshold must be basic/moderate/high |
| FACE_NOT_DETECTED | face not detected from image |
| INVALID_SANDBOX_IMAGE_1_CODE | image 1 not exist in image code sandbox |
| INVALID_SANDBOX_IMAGE_2_CODE | image 2 not exist in image code sandbox |
| INVALID_SANDBOX_IDENTITY | identity of image 1 or image 2 not between A-J |
| INVALID_SANDBOX_NFACE | number of face in image not 1-9 |
| INVALID_PAYLOAD_QUALITY_VALIDATION_DEPENDENCY | is_quality must be true if validate_quality true |
| INVALID_PAYLOAD_ATTRIBUTE_VALIDATION_DEPENDENCY | is_attribute must be true if validate_attribute true |
| INVALID_PAYLOAD_LIVENESS_VALIDATION_DEPENDENCY | is_liveness must be true if validate_liveness true |
| FAIL_ON_1 | fail on liveness |
| FAIL_ON_2 | fail on attribute |
| FAIL_ON_3 | fail on liveness and attribute |
| FAIL_ON_4 | fail on quality |
| FAIL_ON_5 | fail on liveness and quality |
| FAIL_ON_6 | fail on attribute and quality |
| FAIL_ON_7 | fail on liveness, attribute, and quality |
| FAIL_ON_8 | fail on number of face (nface) |
| FAIL_ON_9 | fail on number of face (nface) and liveness |
| FAIL_ON_10 | fail on nfail on number of face (nface) and attribute |
| FAIL_ON_11 | fail on number of face (nface), attribute, and liveness |
| FAIL_ON_12 | fail on number of face (nface) and quality |
| FAIL_ON_13 | fail on number of face (nface), quality, and liveness |
| FAIL_ON_14 | fail on number of face (nface), quality, and attribute |
| FAIL_ON_15 | fail on number of face (nface), quality, attribute, and liveness |
| FAIL_ON_16 | fail on similarity status |
| INTERNAL_SERVER_ERROR | internal server error |