Face Recognition Operations - Identify From Large Person Group
Identifikace typu 1:N k vyhledání nejbližších shod konkrétní osoby dotazované osoby z velké skupiny osob
Pro každou tvář v poli faceIds vypočítá funkce Face Identify podobnosti mezi tváří dotazu a všemi tvářemi ve velké skupině osob (dané parametrem largePersonGroupId) a vrátí kandidátské osoby pro danou tvář seřazenou podle spolehlivosti podobnosti. Velká skupina osob by měla být vytrénovaná tak, aby byla připravená k identifikaci. Další informace najdete v části Trénujte velkou skupinu osob.
Poznámka
-
- Algoritmus umožňuje nezávisle identifikovat více než jednu tvář na stejném požadavku, ale ne více než 10 tváří.
- Každá osoba může mít více než jednu tvář, ale ne více než 248 tváří.
- Vyšší kvalita obrazu tváře znamená lepší přesnost identifikace. Zvažte vysoce kvalitní tváře: přední, průhledné a tváře mají velikost 200 × 200 pixelů (100 pixelů mezi očima) nebo větší.
- Počet vrácených kandidátů je omezen parametrem maxNumOfCandidatesReturned a confidenceThreshold. Pokud není identifikována žádná osoba, budou vrácenými kandidáty prázdné pole.
- Pokud potřebujete najít podobné tváře ze seznamu tváří nebo velkého seznamu tváří místo ze skupiny osob nebo velké skupiny osob, zkuste najít podobné tváře.
- Identifikátory faceId "recognitionModel" přidružené k tvářím dotazu by měly být stejné jako model recognitionModel používaný cílovou skupinou osob nebo velkou skupinou osob.
POST {endpoint}/face/{apiVersion}/identify
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
api
|
path | True |
string |
Verze rozhraní API |
endpoint
|
path | True |
string uri |
Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com) |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
faceIds | True |
string[] |
Pole faceId dotazů vytvořených funkcí Detect Každá z tváří se identifikuje nezávisle na sobě. Platný počet faceId je mezi [1, 10]. |
largePersonGroupId | True |
string |
largePersonGroupId cílové skupiny velké osoby vytvořené uživatelem "Create Velká skupina osob". Parametr personGroupId a largePersonGroupId by se neměl zadávat současně. |
confidenceThreshold |
number |
Přizpůsobená prahová hodnota spolehlivosti identifikace v rozsahu [0, 1]. Pokročilí uživatelé můžou tuto hodnotu upravit tak, aby přepsali výchozí interní prahovou hodnotu, aby se zlepšila přesnost dat scénáře. Poznámka: Není zaručeno, že tato prahová hodnota bude fungovat s jinými daty a po aktualizaci algoritmu. |
|
maxNumOfCandidatesReturned |
integer |
Rozsah hodnoty maxNumOfCandidatesReturned je mezi 1 a 100. Výchozí hodnota je 10. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšné volání vrátí identifikované kandidátské osoby pro každou tvář dotazu. |
|
Other Status Codes |
Neočekávaná chybová odpověď. Headers x-ms-error-code: string |
Zabezpečení
Ocp-Apim-Subscription-Key
Tajný klíč pro vaše předplatné Azure AI Face.
Type:
apiKey
In:
header
AADToken
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Příklady
Identify from LargePersonGroup
Sample Request
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
}
Sample Response
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Definice
Name | Description |
---|---|
Face |
Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages. |
Face |
Odpověď obsahující podrobnosti o chybě. |
Identification |
Kandidát na identifikační hovor. |
Identification |
Identifikujte výsledek. |
FaceError
Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Description |
---|---|---|
code |
string |
Jeden ze serverem definovaných chybových kódů. |
message |
string |
Lidsky čitelná reprezentace chyby. |
FaceErrorResponse
Odpověď obsahující podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
IdentificationCandidate
Kandidát na identifikační hovor.
Name | Typ | Description |
---|---|---|
confidence |
number |
Hodnota spolehlivosti kandidáta. Čím vyšší spolehlivost, tím více podobných. Rozsah mezi [0,1]. |
personId |
string |
personId kandidáta. |
IdentificationResult
Identifikujte výsledek.
Name | Typ | Description |
---|---|---|
candidates |
Identifikovaní kandidáti na danou tvář (seřazené podle spolehlivosti). Velikost pole by neměla být větší než vstupní maxNumOfCandidatesReturned. Pokud není identifikována žádná osoba, vrátí prázdné pole. |
|
faceId |
string |
faceId tváře dotazu. |