Compare Face

post https://api.verihubs.com/v1/face/compare

This method helps you to compare face between 2 images

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 status	Error code	Description
200	FAIL_ON_1	fail on liveness
200	FAIL_ON_2	fail on attribute
200	FAIL_ON_3	fail on liveness and attribute
200	FAIL_ON_4	fail on quality
200	FAIL_ON_5	fail on liveness and quality
200	FAIL_ON_6	fail on attribute and quality
200	FAIL_ON_7	fail on liveness, attribute, and quality
200	FAIL_ON_8	fail on number of face (nface)
200	FAIL_ON_9	fail on number of face (nface) and liveness
200	FAIL_ON_10	fail on number of face (nface) and attribute
200	FAIL_ON_11	fail on number of face (nface), attribute, and liveness
200	FAIL_ON_12	fail on number of face (nface) and quality
200	FAIL_ON_13	fail on number of face (nface), quality, and liveness
200	FAIL_ON_14	fail on number of face (nface), quality, and attribute
200	FAIL_ON_15	fail on number of face (nface), quality, attribute, and liveness
200	FAIL_ON_16	fail on similarity status
400	INVALID_PAYLOAD	no value in payload or empty string more than 1
400	INVALID_PAYLOAD_IMAGE_1_MISSING	invalid payload image 1 not a standard b64/url or image empty string
400	INVALID_PAYLOAD_IMAGE_2_MISSING	invalid payload image 2 not a standard b64/url or image empty string
400	INVALID_PAYLOAD_IMAGE_1_SIZE	invalid payload image 1 size too large
400	INVALID_PAYLOAD_IMAGE_2_SIZE	invalid payload image 2 size too large
400	MISSING_PAYLOAD_IMAGE_1	missing payload image 1
400	MISSING_PAYLOAD_IMAGE_2	missing payload image 2
400	INVALID_PAYLOAD_IMAGE_1_TIMEOUT	timeout getting image 1 from url in 15 seconds
400	INVALID_PAYLOAD_IMAGE_2_TIMEOUT	timeout getting image 2 from url in 15 seconds
400	INVALID_PAYLOAD_IMAGE_1_FORMAT	image unable to be decoded/got from url OR invalid image 1 extension
400	INVALID_PAYLOAD_IMAGE_2_FORMAT	image unable to be decoded/got from url OR invalid image 2 extension
400	FACE_NOT_DETECTED	face not detected from image
400	INVALID_PAYLOAD_QUALITY_VALIDATION_DEPENDENCY	is_quality must be true if validate_quality true
400	INVALID_PAYLOAD_ATTRIBUTE_VALIDATION_DEPENDENCY	is_attribute must be true if validate_attribute true
400	INVALID_PAYLOAD_LIVENESS_VALIDATION_DEPENDENCY	is_liveness must be true if validate_liveness true
400	INVALID_PAYLOAD_THRESHOLD_MISSING	threshold must be basic/moderate/high
403	INSUFFICIENT_QUOTA_COMPARE	usage reach it quota limit for compare (only appears on testing mode)
403	INSUFFICIENT_QUOTA_LIVENESS	usage reach it quota limit for liveness (only appears on testing mode)
500	INTERNAL_SERVER_ERROR	internal server error

time	status	user agent
Retrieving recent requests…

Loading…

Body Params

image_1

string

required

An image file, base64 or URL of the first person.

image_2

string

required

An image file, base64 or URL of the second person.

is_quality

boolean

Defaults to true

A flag to determine whether Image Quality (blur, dark, grayscale) will be computed and return as result. Quality will be computed for both image_1 and image_2 when set as true

is_attribute

boolean

Defaults to true

A flag to determine whether Image Attribute (sunglasses, mask, veil, hat) will be detected and return as result. Attribute will be computed for both image_1 and image_2 when set as true

is_liveness

boolean

Defaults to false

A flag to determine whether Passive Liveness will be computed and return as result. Liveness will be computed for both image_1 and image_2 when set as true. When is_liveness is set to true, it is best that validate_quality is set to true, as liveness is influenced by Quality.

validate_quality

boolean

Defaults to false

Determines whether Quality validation will be executed. The validation consists of checking blur and dark with threshold, and also checking whether the image is a black & white image (grayscale is true).

validate_attribute

boolean

Defaults to false

Determines whether attribute validation will be executed. The validation consists of checking whether sunglasses or mask is detected in the input image.

validate_liveness

boolean

Defaults to false

Determines whether Liveness validation will be executed. The validation checks whether input image is live / spoof.

threshold

string

Determines which threshold level will be used. The threshold either basic/moderate/high

validate_nface

boolean

Defaults to false

Determines whether the number of faces validation will be executed. The validation checks whether the input image consists of more than one face.

Headers

App-ID

string

required

API-Key

string

required

Responses

xxxxxxxxxx
curl --request POST \
     --url https://api.verihubs.com/v1/face/compare \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "is_quality": true,
  "is_attribute": true,
  "is_liveness": false,
  "validate_quality": false,
  "validate_attribute": false,
  "validate_liveness": false,
  "validate_nface": false
}
'

200Successful Response

400Bad Request

401Unauthorized

500Internal Server Error