Face Recognition Operations - Identify From Large Person Group

Tjänst:

Azure AI Services

API-version:

v1.2-preview.1

1-till-många-identifiering för att hitta de närmaste matchningarna för den specifika frågepersonens ansikte från en stor persongrupp.
För varje ansikte i matrisen faceIds beräknar Ansiktsigenkänning likheter mellan frågeansiktet och alla ansikten i gruppen Stor person (som ges av largePersonGroupId) och returnerar kandidatpersoner för det ansiktet rangordnat efter likhetsförtroende. Gruppen Stor person bör tränas för att göra den redo för identifiering. Mer information finns i "Träna stor persongrupp".

Not

• • Algoritmen gör att mer än ett ansikte kan identifieras oberoende av varandra på samma begäran, men högst 10 ansikten.
  • Varje person kan ha mer än ett ansikte, men inte mer än 248 ansikten.
  • Högre ansiktsbildkvalitet innebär bättre identifieringsprecision. Överväg högkvalitativa ansikten: frontal, klar och ansiktsstorlek är 200 x 200 bildpunkter (100 bildpunkter mellan ögonen) eller större.
  • Antalet kandidater som returneras begränsas av maxNumOfCandidatesReturned och confidenceThreshold. Om ingen person identifieras blir de returnerade kandidaterna en tom matris.
  • Prova "Hitta liknande" när du behöver hitta liknande ansikten från en ansiktslista/stor ansiktslista i stället för en persongrupp/stor persongrupp.
  • FaceIds för "recognitionModel" som är associerad med frågans ansikten ska vara samma som "recognitionModel" som används av målpersongruppen eller den stora persongruppen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
apiVersion	path	True	string	API-version
endpoint	path	True	string uri	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com).

Begärandetext

Name	Obligatorisk	Typ	Description
faceIds	True	string[]	Matris med fråge ansikten faceIds, som skapats av "Detect". Var och en av ansiktena identifieras oberoende av varandra. Det giltiga antalet faceIds är mellan [1, 10].
largePersonGroupId	True	string	largePersonGroupId för den stora målgruppen för målet, skapad av "Skapa stor persongrupp". ParameterpersonGroupId och largePersonGroupId bör inte anges samtidigt.
confidenceThreshold		number	Tröskelvärde för anpassad identifieringsförtroende i intervallet [0, 1]. Avancerad användare kan justera det här värdet för att åsidosätta det interna standardtröskelvärdet för bättre precision på sina scenariodata. Observera att det inte finns någon garanti för att det här tröskelvärdet fungerar med andra data och efter uppdateringar av algoritmen.
maxNumOfCandidatesReturned		integer	Intervallet för maxNumOfCandidatesReturned är mellan 1 och 100. Standardvärdet är 10.

Svar

Name	Typ	Description
200 OK	IdentificationResult[]	Ett lyckat anrop returnerar identifierade kandidatpersoner för varje frågeyta.
Other Status Codes	FaceErrorResponse	Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string

Säkerhet

Ocp-Apim-Subscription-Key

Den hemliga nyckeln för din Azure AI Face-prenumeration.

Typ: apiKey
I: header

AADToken

The Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: accessCode
Auktoriseringswebbadress: https://api.example.com/oauth2/authorize
Token-webbadress: https://api.example.com/oauth2/token

Omfattningar

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

Exempel

Identify from LargePersonGroup

Exempelbegäran

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "largePersonGroupId": "your_large_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Exempelsvar

Statuskod:

200

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

Definitioner

Name	Description
FaceError	Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ett svar som innehåller felinformation.
IdentificationCandidate	Kandidat för identifieringsanrop.
IdentificationResult	Identifiera resultat.

FaceError

Felobjektet. Mer information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
message	string	En mänsklig läsbar representation av felet.

FaceErrorResponse

Ett svar som innehåller felinformation.

Name	Typ	Description
error	FaceError	Felobjektet.

IdentificationCandidate

Kandidat för identifieringsanrop.

Name	Typ	Description
confidence	number	Förtroendevärde för kandidaten. Ju högre konfidens, desto mer lika. Intervall mellan [0,1].
personId	string	personId för kandidatperson.

IdentificationResult

Identifiera resultat.

Name	Typ	Description
candidates	IdentificationCandidate[]	Identifierade personkandidater för det ansiktet (rangordnade efter förtroende). Matrisstorleken får inte vara större än indata maxNumOfCandidatesReturned. Om ingen person identifieras returneras en tom matris.
faceId	string	faceId för frågeigenkänningen.