Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Compare the photo and the video uploaded through the interface to determine whether the faces belong to the same person.
For photo and video standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
check_quality
can currently only evaluate face occlusion. Other evaluation items may be added in the future.
The possible results ofliveness_status
are as follows:
Correlations between the verification score threshold and the error rate:
Recommended threshold: greater than 0.7.
Name
Type
Required
Description
encrypted_video
string
Yes
Encrypted video Encryption method reference: [Photo and Video Encryption]
encrypted_image
string
Yes
Encrypted photo Encryption method reference: [Photo and Video Encryption]
auto_rotate
boolean
No
The default value is false, indicating that the photo is not rotated. When the value is true, the photo is automatically rotated.
check_quality
boolean
No
The default value is false, and no quality test is performed. When the value is true, the photo quality is checked.
return_image
boolean
No
Whether to return the selected frame of face and timestamp of the selected frame of the photo. The default is false. image_timestamp
and base64_image
are returned only when this value is true and the live detection is passed.
return_face_image
boolean
No
Whether to return the face clipping of the selected frame of the photo. The default is false. base64_face_image
is returned only when this value is true and the live detection is passed.
return_status
boolean
No
Whether to return the error status description. The default is false. liveness_status
is returned only when this value is true.
Name
Type
Description
code
int
System response code: 1000
passed
boolean
Liveness detection passed or not
liveness_score
float
The score of silent liveness detection (for reference only, please refer to the passed field)
liveness_status
string
Description of the error status of silent liveness detection. This field is returned when return_status=true
verification_score
float
Face comparison score, recommended threshold: > 0.7. This field is returned when passed=true
image_timestamp
float
Timestamp of the selected frame of image in seconds. This field is returned only when passed=true and return_image=true
base64_image
string
The selected frame of the photo. This field is returned only when passed=true and return_image=true
base64_face_image
string
Face clipping of the selected frame of the photo. This field is returned only when passed=true and return_face_image=true
request_id
string
The ID of this request
Status
Description
ok
Silent liveness detection passed: the person in the video is real
hack
Silent liveness detection failed, reason: face spoofing (for example, photos taken by the mobile phone)
short_time
Silent liveness detection failed, reason: video time less than 2s
Threshold
0.4
0.5
0.6
0.7
0.8
0.9
error rate
1/10
1/100
1/1000
1/10,000
1/100,000
1/1,000,000
Name
Type
Instructions
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2003
invalid image size
The image size (height and width in pixel) does not meet the requirements
2004
invalid content length
The image file size does not meet the requirements
2005
invalid image type or corrupted
The image type does not meet the requirements
4000
detection failed
Feature extraction failed, no face detected in the image
4004
face occlusion
The face is detected, but the eyes, nose, or mouth are partially occluded
4007
liveness silent check failed
Silent liveness detection failed
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR
This manual provides instructions on how to use the SenseID APIs.
In this manual, we will provide detailed procedures for all APIs provided by SenseID on a case-by-case basis for readers to consult when necessary. The instructions on API include function introduction, parameters, responses, error messages, etc.
Compare the two photos with multiple faces included and uploaded through the interface to get the similarity score of each pair of faces in the two photos.
For photo standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
For example:
Suppose that Photo A corresponding to first_image_file contains two faces (a1, a2); Photo B corresponding to second_image_file contains two faces (b1, b2); a1b1 represents the comparison score of face a1 in Photo A and face b1 in Photo B. The response is like:
Correlations between the verification score threshold and the error rate:
Recommended threshold: greater than 0.7.
Perform silent liveness detection on the server to decide whether the person in the uploaded video is a living human or not.
For video standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
The possible results ofliveness_status
are as follows:
Compare the photo and the liveness data uploaded through the interface to determine whether the faces belong to the same person.
For photo standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
Correlations between the verification score threshold and the error rate:
Recommended threshold: greater than 0.7.
Perform a quality check of the photo.
The photo file can contain multiple faces.
For photo standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
Compare the two photos including only one face each uploaded through the interface to determine whether the two faces belong to the same person.
For photo standards, refer to Chapter 3 Photo and Video Standards in the Operation Manual.
POST
Correlations between the verification score threshold and the error rate:
Recommended threshold: greater than 0.7.
Name
Type
Required
Description
first_encrypted_image
string
Yes
Encrypted photo 1. Encryption method reference: [Photo and Video Encryption]
second_encrypted_image
string
Yes
Encrypted photo 2. Encryption method reference: [Photo and Video Encryption]
auto_rotate
boolean
No
The default value is false, indicating that the photo is not rotated. When the value is true, the photo is automatically rotated.
Name
Type
Description
code
int
System response code: 1000
scores
array
The face comparison score of each group of photos
is from 0-1. The greater the value, the greater the probability that the two faces belong to the same person.
face_rects
hash
Face frame in each photo
request_id
string
The ID of this request
Threshold
0.4
0.5
0.6
0.7
0.8
0.9
error rate
1/10
1/100
1/1000
1/10,000
1/100,000
1/1,000,000
Name
Type
Description
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2003
invalid image size
The image size (height and width in pixel) does not meet the requirements
2004
invalid content length
The image file size does not meet the requirements
2005
invalid image type or corrupted
The image type does not meet the requirements
2006
corrupted image error
Image corrupted
4000
detection failed
Feature extraction failed, no face detected in the image
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR
Date
Revised content
2021/08/20
Deleted the unused error code 2006 from Chapter 1 Face Compare and Chapter 2 Quality Check.
Added descriptions to the error code 2003 and 2004 in Chapter 1 Face Compare and Chapter 2 Quality Check.
Deleted the unused liveness status from Section 1.4 /identity/silent_image_verification/stateless and Chapter 3 Liveness Detection.
2021/03/08
The first edition released
Name
Type
Required
Description
encrypted_video
string
Yes
Encrypted video Encryption method reference: [Photo and Video Encryption]
return_image
boolean
No
Whether to return the selected frame of face and timestamp of the selected frame of the photo. The default is false. image_timestamp
and base64_image
are returned only when this value is true and the live detection is passed.
return_face_image
boolean
No
Whether to return the face clipping of the selected frame of the photo. The default is false. base64_face_image
is returned only when this value is true and the live detection is passed.
return_status
boolean
No
Whether to return the error status description. The default is false. liveness_status
is returned only when this value is true.
Name
Type
Description
code
int
System response code: 1000
passed
boolean
Liveness detection passed or not
liveness_score
float
The score of silent liveness detection (for reference only, please refer to the passed field)
liveness_status
string
Description of the error status of silent liveness detection. This field is returned when return_status=true
image_timestamp
float
Timestamp of the selected frame of image in seconds. This field is returned only when passed=true and return_image=true
base64_image
string
The selected frame of the photo. This field is returned only when passed=true and return_image=true
base64_face_image
string
Face clipping of the selected frame of the photo. This field is returned only when passed=true and return_face_image=true
request_id
string
The ID of this request
Status
Description
ok
Silent liveness detection passed: the person in the video is real
hack
Silent liveness detection failed, reason: face spoofing (for example, photos taken by the mobile phone)
short_time
Silent liveness detection failed, reason: video time with the face is less than 2s
Name
Type
Instructions
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2008
invalid video error
Invalid videos (video time is less than 2s)
4007
liveness silent check failed
Silent liveness detection failed
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR
Name
Type
Required
Description
liveness_file
file
Yes
The encrypted binary stream file (i.e., protobufData) returned after the successful detection by interactive liveness or silent liveness SDK is already encrypted without additional encryption required
encrypted_image
string
Yes
Encrypted photo Encryption method reference: [Photo and Video Encryption]
auto_rotate
boolean
No
The default value is false, indicating that the photo is not rotated. When the value is true, the photo is automatically rotated.
check_quality
boolean
No
The default value is false, and no quality test is performed. When the value is true, the photo quality is checked.
Name
Type
Instructions
code
int
System response code: 1000
verification_score
float
The face comparison score is from 0-1. The greater the value, the greater the probability that the two faces belong to the same person.
request_id
string
The ID of this request
Threshold
0.4
0.5
0.6
0.7
0.8
0.9
error rate
1/10
1/100
1/1000
1/10,000
1/100,000
1/1,000,000
Name
Type
Instructions
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2003
invalid image size
The image size (height and width in pixel) does not meet the requirements
2004
invalid content length
The image file size does not meet the requirements
2005
invalid image type or corrupted
The image type does not meet the requirements
2007
corrupted liveness data error
Liveness data corruption
4000
detection failed
Feature extraction failed, no face detected in the image
4004
face occlusion
Face detected but partially obscured by eyes, nose, or mouth
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR
Name
Type
Required
Description
encrypted_image
string
Yes
Encrypted photo Encryption method reference: [Photo and Video Encryption]
Name
Type
Description
code
int
System response code: 1000
faces
Array
Information about the quality of each face in the photo
request_id
string
The ID of this request
Name
Type
Instructions
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2003
invalid image size
The image size (height and width in pixel) does not meet the requirements
2004
invalid content length
The image file size does not meet the requirements
2005
invalid image type or corrupted
The image type does not meet the requirements
4000
detection failed
Feature extraction failed, no face detected in the image
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR
Name
Type
Required
Description
first_encrypted_image
string
Yes
Encrypted photo 1. Encryption method reference: [Photo and Video Encryption]
second_encrypted_image
string
Yes
Encrypted photo 2. Encryption method reference: [Photo and Video Encryption]
auto_rotate
boolean
No
The default value is false, indicating that the photo is not rotated. When the value is true, the photo is automatically rotated.
check_quality
boolean
No
The default value is false, and no quality test is performed. When the value is true, the photo quality is checked.
Name
Type
Instructions
code
int
System response code: 1000
verification_score
float
The face comparison score is from 0-1. The greater the value, the greater the probability that the two faces belong to the same person.
request_id
string
The ID of this request
Threshold
0.4
0.5
0.6
0.7
0.8
0.9
error rate
1/10
1/100
1/1000
1/10,000
1/100,000
1/1,000,000
Name
Type
Instructions
code
int
System response code
message
string
Error Messages
request_id
string
The ID of this request
code
Field value
Description
1200
invalid argument
Invalid input parameter
2003
invalid image size
The image size (height and width in pixel) does not meet the requirements
2004
invalid content length
The image file size does not meet the requirements
2005
invalid image type or corrupted
The image type does not meet the requirements
4000
detection failed
Feature extraction failed, no face detected in the image
4004
face occlusion
Face detected but partially obscured by eyes, nose, or mouth
status
Description
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR