Face Recognition Operations - Identify From Large Person Group
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 den stora persongruppen (givet av largePersonGroupId) och returnerar kandidatpersoner för det ansiktet rangordnat efter likhetsförtroende. Gruppen Stor person bör utbildas för att göra den redo för identifiering. Mer information finns i "Träna stor persongrupp".
Anteckning
-
- Algoritmen gör att mer än ett ansikte kan identifieras oberoende på samma begäran, men inte fler än 10 ansikten.
- Varje person kan ha mer än ett ansikte, men inte mer än 248 ansikten.
- Högre bildkvalitet för ansiktsigenkänning innebär bättre identifieringsprecision. Överväg högkvalitativa ansikten: frontal, klar och ansiktsstorlek är 200 x 200 bildpunkter (100 bildpunkter mellan ögon) 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.
- FaceId:erna för "recognitionModel" som är associerade med frågeytorna ska vara samma som "recognitionModel" som används av målgruppen eller gruppen Stor person.
POST {endpoint}/face/{apiVersion}/identify
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
api
|
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 faceIds för frågor som skapats av "Detect". Vart och ett av ansiktena identifieras oberoende av varandra. Det giltiga antalet faceIds är mellan [1, 10]. |
largePersonGroupId | True |
string |
largePersonGroupId för den stora målgruppen, skapad av "Skapa large person group". Parametern personGroupId och largePersonGroupId ska inte anges samtidigt. |
confidenceThreshold |
number |
Anpassat tröskelvärde för 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 algoritmuppdateringar. |
|
maxNumOfCandidatesReturned |
integer |
Intervallet för maxNumOfCandidatesReturned är mellan 1 och 100. Standardvärdet är 10. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Ett lyckat anrop returnerar den eller de identifierade kandidatpersonerna för varje frågeyta. |
|
Other Status Codes |
Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string |
Säkerhet
Ocp-Apim-Subscription-Key
Den hemliga nyckeln för din Ansiktsprenumeration på Azure AI.
Typ:
apiKey
I:
header
AADToken
Azure Active Directory OAuth2-flödet
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
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"largePersonGroupId": "your_large_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Exempelsvar
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Definitioner
Name | Description |
---|---|
Face |
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på följande länk: https://aka.ms/face-error-codes-and-messages. |
Face |
Ett svar som innehåller felinformation. |
Identification |
Kandidat för att identifiera samtal. |
Identification |
Identifiera resultatet. |
FaceError
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns på 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 |
Felobjektet. |
IdentificationCandidate
Kandidat för att identifiera samtal.
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 resultatet.
Name | Typ | Description |
---|---|---|
candidates |
Identifierade personkandidater för det ansiktet (rangordnade efter konfidens). Matrisstorleken får inte vara större än indata maxNumOfCandidatesReturned. Om ingen person identifieras returneras en tom matris. |
|
faceId |
string |
faceId för frågans ansikte. |