Face Recognition Operations - Identify From Person Directory

Service:

Azure AI Services

API-versie:

v1.2-preview.1

1-op-veel identificatie om de dichtstbijzijnde overeenkomsten te vinden van de specifieke query persoon gezicht uit een person directory personIds matrix.
Voor elk gezicht in de faceIds-matrix berekent Face Identify overeenkomsten tussen het querygezicht en alle gezichten in de persoonsdirectory-personen (gegeven door personIds) en retourneert u kandidaat-persoon(en) voor dat gezicht gerangschikt op gelijkenisvertrouwen. Door personIds door te geven met een matrix met één element '*' kan de bewerking worden uitgevoerd via de hele personenmap.

Notitie

• • Met het algoritme kunnen meerdere gezichten onafhankelijk worden geïdentificeerd op dezelfde aanvraag, maar niet meer dan 10 gezichten.
  • Elke persoon kan meer dan één gezicht hebben, maar niet meer dan 248 gezichten.
  • Een hogere afbeeldingskwaliteit van het gezicht betekent een betere identificatieprecisie. Overweeg gezichten van hoge kwaliteit: frontaal, helder en gezichtsgrootte is 200x200 pixels (100 pixels tussen ogen) of groter.
  • Het aantal geretourneerde kandidaten wordt beperkt door maxNumOfCandidatesReturned en confidenceThreshold. Als er geen persoon wordt geïdentificeerd, zijn de geretourneerde kandidaten een lege matrix.
  • De identificatiebewerking kan alleen overeenkomen met gezichten die zijn verkregen met hetzelfde herkenningsmodel, dat is gekoppeld aan de query gezichten.

POST {endpoint}/face/{apiVersion}/identify

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
faceIds	True	string[] (uuid)	Matrix van faceIds van query gezichten, gemaakt door de 'Detect'. Elk van de gezichten wordt onafhankelijk geïdentificeerd. Het geldige aantal faceIds ligt tussen [1, 10].
personIds	True	string[] (uuid)	Matrix van personIds die zijn gemaakt in person directory 'Create Person'. Het geldige aantal personIds ligt tussen [1,30].
confidenceThreshold		number (float) minimum: 0 maximum: 1	Aangepaste drempelwaarde voor identificatievertrouwen, in het bereik van [0, 1]. Geavanceerde gebruikers kunnen deze waarde aanpassen om de standaard interne drempelwaarde te overschrijven voor een betere precisie van hun scenariogegevens. Houd er rekening mee dat deze drempelwaarde niet kan worden gegarandeerd voor andere gegevens en na het bijwerken van het algoritme.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 100	Het bereik van maxNumOfCandidatesReturned ligt tussen 1 en 100. De standaardwaarde is 10.

Antwoorden

Name	Type	Description
200 OK	IdentificationResult[]	Een geslaagde aanroep retourneert de geïdentificeerde kandidaat-persoon(en) voor elk query-gezicht.
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

Identify from PersonDirectory

Voorbeeldaanvraag

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ],
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Voorbeeldrespons

Statuscode:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

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.
IdentificationCandidate	Kandidaat voor identificatiegesprek.
IdentificationResult	Resultaat identificeren.

FaceError

Object

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

Object

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

IdentificationCandidate

Object

Kandidaat voor identificatiegesprek.

Name	Type	Description
confidence	number (float) minimum: 0 maximum: 1	Betrouwbaarheidswaarde van de kandidaat. Hoe hoger het vertrouwen, hoe vergelijkbaarer. Bereik tussen [0,1].
personId	string (uuid)	personId van kandidaat-persoon.

IdentificationResult

Object

Resultaat identificeren.

Name	Type	Description
candidates	IdentificationCandidate[]	Geïdentificeerde persoonskandidaten voor dat gezicht (gerangschikt op vertrouwen). De matrixgrootte mag niet groter zijn dan de invoer maxNumOfCandidatesReturned. Als er geen persoon wordt geïdentificeerd, retourneert u een lege matrix.
faceId	string (uuid)	faceId van het query-gezicht.