AddFaces

Route that allows adding a face to a face database from an image file.

Function

The AddFaces route's sole function is to add faces to the specified database. It does not perform searches or duplicate checks – this check should be done beforehand through the SearchFaceImage route.

Behavior with Identical Images

If exactly the same image is sent more than once to the AddFaces route, it will return the same face ID already registered, avoiding exact duplicates.

Behavior with Different Faces of the Same Person

When different images of the same person are sent (e.g., photos taken at different times), each one will receive a unique and distinct ID. This is expected as they are different representations of the same identity.

Face Selection in the Image

If an image contains multiple faces, the API will automatically select and register only the face that occupies the largest area in the image. The other faces will be ignored.

Suggested Flow

Considering these characteristics, we suggest structuring the flow as follows:

First: Use the SearchFaceImage route to check if the face already exists in the database

Then: Only if no match is found, use the AddFaces route to add the new face.

This sequence ensures that the duplicate check is done properly before storage, taking advantage of the specific functionalities of each route.

Function #

Behavior with Identical Images #

Behavior with Different Faces of the Same Person #

Face Selection in the Image #

Suggested Flow#

Function

Behavior with Identical Images

Behavior with Different Faces of the Same Person

Face Selection in the Image

Suggested Flow