Face Recognition Operations - Find Similar From Face List

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Gezien de faceId van het querygezicht, kunt u de gezichten in een gezichtslijst doorzoeken die er ongeveer uitzien. Er wordt een faceListId gemaakt door Face List maken.
Afhankelijk van de invoer bevat de geretourneerde lijst met vergelijkbare gezichten faceIds of persistentedFaceIds gerangschikt op gelijkenis.

Zoeken op vergelijkbare manier heeft twee werkmodi, 'matchPerson' en 'matchFace'. "matchPerson" is de standaardmodus waarmee wordt geprobeerd gezichten van dezelfde persoon te vinden door interne drempelwaarden van dezelfde persoon te gebruiken. Het is handig om de andere foto's van een bekende persoon te vinden. Houd er rekening mee dat er een lege lijst wordt geretourneerd als er geen gezichten voldoen aan de interne drempelwaarden. De 'matchFace'-modus negeert drempelwaarden van dezelfde persoon en retourneert toch gerangschikte vergelijkbare gezichten, zelfs de gelijkenis is laag. Het kan worden gebruikt in de gevallen zoals het doorzoeken van beroemdheidsgezichten.

Het 'recognitionModel' dat is gekoppeld aan de query faceId, moet hetzelfde zijn als het 'recognitionModel' dat wordt gebruikt door de doelgezichtlijst.

POST {endpoint}/face/{apiVersion}/findsimilars

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

Aanvraagbody

Name	Vereist	Type	Description
faceId	True	string	faceId van het query-gezicht. De gebruiker moet eerst 'Detecteren' aanroepen om een geldige faceId op te halen. Houd er rekening mee dat deze faceId niet behouden blijft en 24 uur na de detectieaanroep verloopt.
faceListId	True	string	Een bestaande door de gebruiker opgegeven unieke lijst met gezichten die is gemaakt in 'Gezichtslijst maken'. Face List bevat een set persistenteFaceIds die behouden blijven en nooit verlopen.
maxNumOfCandidatesReturned		integer	Het aantal meest overeenkomende gezichten dat wordt geretourneerd. Het geldige bereik is [1, 1000]. De standaardwaarde is 20.
mode		FindSimilarMatchMode	Vergelijkbare modus voor zoeken naar gezichten. Dit kan 'matchPerson' of 'matchFace' zijn. De standaardwaarde is 'matchPerson'.

Antwoorden

Name	Type	Description
200 OK	FindSimilarResult[]	Een geslaagde aanroep retourneert een matrix van de meest vergelijkbare gezichten die worden weergegeven in faceId als de invoerparameter faceIds is of persistentedFaceId als de invoerparameter faceListId of largeFaceListId is.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

Name	Description
https://cognitiveservices.azure.com/.default

Voorbeelden

Find Similar from FaceList

Voorbeeldaanvraag

HTTP

POST {endpoint}/face/v1.2-preview.1/findsimilars

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceListId": "your_face_list_id"
}

Voorbeeldrespons

Statuscode:

200

[
  {
    "confidence": 0.8,
    "faceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
FindSimilarResult	Antwoordtekst voor het vinden van vergelijkbare gezichtsbewerkingen.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

FindSimilarResult

Antwoordtekst voor het vinden van vergelijkbare gezichtsbewerkingen.

Name	Type	Description
confidence	number	Betrouwbaarheidswaarde van de kandidaat. Hoe hoger het vertrouwen, hoe vergelijkbaarer. Bereik tussen [0,1].
faceId	string	faceId van kandidaat-gezicht wanneer deze wordt gevonden door faceIds. faceId wordt gemaakt door 'Detecteren' en verloopt 24 uur na de detectieaanroep.
persistedFaceId	string	persistentedFaceId van kandidaatgezicht wanneer deze wordt gevonden op faceListId of largeFaceListId. persistentedFaceId in gezichtslijst/grote gezichtslijst blijft behouden en verloopt niet.