Face Recognition Operations - Identify From Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

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
apiVersion	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	IdentificationResult[]	Úspěšné volání vrátí identifikované kandidátské osoby pro každou tvář dotazu.
Other Status Codes	FaceErrorResponse	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

HTTP

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

Status code:

200

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

Definice

Name	Description
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.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
IdentificationCandidate	Kandidát na identifikační hovor.
IdentificationResult	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	FaceError	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	IdentificationCandidate[]	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.