1-to-many identification to find the closest matches of the specific query person face from a person group or large person group.

post/identify

Request body

faceIdsstring[] required

Array of query faces faceIds, created by the Face - Detect. Each of the faces are identified independently. The valid number of faceIds is between [1, 10].

personGroupIdstring

PersonGroupId of the target person group, created by PersonGroup - Create. Parameter personGroupId and largePersonGroupId should not be provided at the same time.

largePersonGroupIdstring

LargePersonGroupId of the target large person group, created by LargePersonGroup - Create. Parameter personGroupId and largePersonGroupId should not be provided at the same time.

maxNumOfCandidatesReturnedinteger

The range of maxNumOfCandidatesReturned is between 1 and 5 (default is 1).

confidenceThresholdnumber

A number ranging from 0 to 1 indicating a level of confidence associated with a property.

Response

A successful call returns the identified candidate person(s) for each query face.

faceIdstring uuid required

FaceId of the query face

Changes