Face Detection without faceID |
Detects faces within images
Includes the following parameters:- returnFaceLandmarks
- returnFaceAttributes
- detectionModel
Scenario: Face detection |
Image (binary or URL download) |
Coordinates of the bounding box location(s) of the face(s) are generalized regardless of who is in the image. Cannot be used to recognize faces or otherwise uniquely identify individuals. |
No template is created |
N/A |
Face Detection with faceID |
Returns a face ID to be used for the Face recognition APIs (Identify, Verify API, Group API, and Find Similar).
Face ID is only supported for customers who have been approved for access.
Includes the following parameters:- returnFaceId=true
- recognitionModel
- returnRecognitionModel
- faceIdTimeToLive
Scenario: Facial Verification and Facial Identification (approved customers only) |
Image (binary or URL download) |
FaceID, a randomly generated identifier assigned to a new face feature template for each image submitted to Face API. The FaceID changes for each image submitted, even if the image is of the same face. There's no matching or comparison in Detect API with FaceID. |
The face template expires within 24 hours. |
The FaceId template expiration date can be adjusted to less than 24 hours with the faceIdTimeToLive parameter. |
Face Liveness (Kotlin, Swift) |
Detects face liveness.
(approved customers only) |
Video |
Enumeration of real, spoof, or uncertain. |
One or more templates may be created. Templates are not stored after analysis. |
N/A |
Verify |
Performs a one-to-one match between a FaceID and either another FaceID, a PersonGroupPerson, a LargePersonGroupPerson, or a PersonDirectoryPerson.
Scenario: Facial Verification and Facial Identification (approved customers only) |
Both of:- A FaceID array from the Detect API (with
returnFaceId=true ) - One of the following:
- Another FaceID array from the Detect API (with
returnFaceId=true ) - A PersonId and one of the following:
|
Determines whether a FaceID is a match compared to the other FaceID. |
The FaceID array and associated face template created with Face Detect’s FaceID feature expire within 24 hours.
The input PersonGroupId, LargePersonGroupId, or PersonDirectory face templates will not expire. |
The FaceId template expiration date can be adjusted to less than 24 hours with faceIdTimeToLive.
PersonGroupId, LargePersonGroupId, PersonIds, and their persistedFaceIds can be managed and deleted by the customer with the following APIs:
Person deletion (Deleting a Person also deletes their associated Face templates):- PersonGroupPerson - Delete
- LargePersonGroupPerson - Delete
- PersonDirectoryPerson - Delete
Person Face deletion- PersonGroupPersonFace - Delete
- LargePersonGroupPersonFace - Delete
- PersonDirectoryPersonFace - Delete
|
Identify |
Given a FaceID, performs a 1-to-N search for similar-looking persons in a FaceID array, a personGroupId, a largePersonGroupId, a dynamicPersonGroupId, or a list of PersonDirectory persons.
Scenario: Facial Identification (Approved Customer Only) |
- FaceID Array From Detect API with returnFaceId=true
- One of the following:
|
For each FaceID provided, a list of candidate PersonIds from the corresponding input search group. |
The faceID array and associated face template created with Face Detect’s FaceId feature expire within 24 hours.
The input PersonGroupId created by PersonGroup Create API contains PersonGroupPersons with associated persistedFaceId face templates that will not expire.
The input LargePersonGroupId created by LargePersonGroup Create API contains LargePersonGroupPersons with associated persistedFaceIds face templates that will not expire.
The input PersonDirectory Persons created by PersonDirectory Person Create API and referenced by DynamicPersonGroup Create contains PersonDirectoryPersons with associated persistedFaceIds face templates that will not expire.
|
The FaceIDs array template's expiration can be adjusted to less than 24 hours with the Detect API query parameter faceIdTimeToLive
faceListId; largeFaceListId; and persistentFaceIds can be managed and deleted by customers with the Face API commands. |
Find Similar |
Given a face, searches for similar-looking faces from a faceID array, a faceListId or a largeFaceListId.
Depending on the type of Customer request (for a faceID array or a faceListID), the results returned to customers contain faceIDs or persistedFaceIDs ranked by similarity.
Scenario: Facial Identification (Approved Customer Only) |
The FaceID or FaceID Array From Detect API returnFaceId=true
faceListID; largeFaceListID |
The matching persistedFaceID, with confidence score |
The input faceID array may contain multiple faces detected by Detect API. These faceID array and associated face template expires within 24 hours.
The input faceListID is created by FaceList – Create API containing persistedFaceIDs and associated face template that will not expire.
The input largeFaceListID is created by LargeFaceList – Create API containing persistedFaceIDs and associated face template that will also not expire. |
FaceIDs array template expiration can be adjusted to less than 24 hours with Detect API query parameter faceIdTimeToLive
faceListID; LargeFaceListID; and PersistentFaceIDs can be managed and deleted by Customers via the Face API commands. |
Group |
Group similar faces together
Scenario: Facial Identification (Approved Customer Only) |
FaceID Array From Detect API returnFaceId=true
|
One or more groups of faceIDs |
The grouping of faceID’s is not persisted beyond request.
The faceID array and associated face template expires within 24 hours. |
FaceIDs array template expiration can be adjusted to less than 24 hours with Detect API query parameter faceIdTimeToLive |
FaceList
LargeFaceList |
Data structures for storing face templates in FaceLists or LargeFaceLists for use with future FindSimilar or Verify operations.
Scenario: Facial Verification & Facial Identification (Approved Customer Only) |
Image |
persistedFaceIds |
The input faceListID is created by FaceList – Create API containing persistedFaceIDs and associated face template that will not expire.
The input largeFaceListID is created by LargeFaceList – Create API containing persistedFaceIDs and associated face template that will also not expire. |
faceListID; LargeFaceListID; and PersistentFaceIDs can be managed and deleted by customer using the corresponding REST CRUD APIs for each data structure. |
PersonGroup
LargePersonGroup
PersonDirectory |
Data structures for storing multiple face templates per Person. PersonGroup(Persons), LargePersonGroup(Persons), PersonDirectory(Persons) are for use with future Identify or Verify operations.
Scenario: Facial Verification & Facial Identification (Approved Customer Only) |
Image |
persistedFaceIds |
The input PersonGroupId created by PersonGroup - Create API contains PersonGroupPersons with associated persistedFaceIds face templates that will not expire.
The input LargePersonGroupId created by LargePersonGroup - Create API contains LargePersonGroupPersons with associated persistedFaceIds face templates that will not expire.
The input PersonDirectory Persons created by PersonDirectory Person - Create API and referenced by DynamicPersonGroup - Create API contains PersonDirectoryPersons with associated persistedFaceIds face templates that will not |
PersonGroupPersonIds, LargePersonGroupPersonIds, and PersonDirectoryPersonIds can be managed and deleted by customer using the corresponding REST CRUD APIs for each data structure. |
Detect Liveness Session |
Detects whether face within an image is a genuine presentation instead of a spoofing specimen
Scenario: Liveness Detection (Approved Customers Only) |
deviceCorrelationId: a non-PII identifier provided by the customer to link sessions from the same device together over a 48-hour period.
Liveness Images |
SessionId: a random generated Identifier (GUID), history of session-associated operations (such as facial liveness detection) are linked.
Authorization Token: for a client device to authenticate to Face API directly. |
No face template is created. |
Session data is automatically deleted after 48 hours or may be deleted by the customer using DetectLivenessSession - Delete API |
Liveness Detection |
Detects whether face within an image is a genuine presentation instead of a spoofing specimen
Scenario: Liveness Detection (Approved Customers Only) |
Liveness Images |
Classification result of either live or spoofed faces |
No face template is created. |
N/A |
Detect Liveness With Verify Session |
Detects whether face within an image is a genuine presentation instead of a spoofing specimen and compares it to a known image of the person providing a face match confidence score to help ensure identity of the individual is the same.
Scenario: Liveness Detection & Facial Verification (Approved Customers Only) |
deviceCorrelationId: a non-PII identifier provided by the customer to link sessions from the same device together over a 48 hour period.
Liveness Images
Reference Image |
SessionId: a random generated Identifier (GUID), history of session-associated operations (such as facial liveness detection) are linked.
Authorization Token: for a client device to authenticate to Face API directly.
Face Rectangle and classification result of either live or spoofed faces
Target Rectangle of reference image and confidence score of match |
If Verification reference image is provided during DetectLivenessWithVerify Session - Create API, Face templates is stored for up to 48 hours or session is deleted by the customer. |
Session data is automatically deleted after 48 hours or may be deleted by the customer using DetectLivenessWithVerify Session - Delete API |
Liveness Detection with Verify |
Detects whether face within an image is a genuine presentation instead of a spoofing specimen and compares it to a known image of the person providing a face match confidence score to help ensure identity of the individual is the same.
Scenario: Liveness Detection & Facial Verification (Approved Customers Only) |
Liveness Images
Reference Image |
Face Rectangle and classification result of either live or spoof face
Target Rectangle of reference image and confidence score of match |
If Verification reference image is provided during DetectLivenessWithVerify Session - Create API, Face templates is stored for up to 48 hours or session is deleted by the customer.
If Verification Image is provided at the same time the liveness payload is provided, then templates are not stored past the length of the call. |
Session data is automatically deleted after 48 hours or may be deleted by the customer using Session DetectLivenessWithVerify - Delete API |