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:1.
First: Use the SearchFaceImage route to check if the face already exists in the database 2.
Then: Only if no match is found, use the AddFaces route to add the new face.
Modified at 2025-09-12 19:26:01
