Face Recognition Operations - Identify From Large Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Identifikace 1:N, která najde nejbližší shodu konkrétní osoby dotazu z velké skupiny osob.
Pro každou tvář v poli faceIds bude funkce Face Identify vypočítat podobnosti mezi tváří dotazu a všemi tvářemi ve skupině Velkých osob (s ohledem na largePersonGroupId) a vrátit kandidátské osoby pro danou tvář seřazenou podle spolehlivosti podobnosti. Velká skupina osob by měla být vytrénována, aby byla připravená k identifikaci. Další informace najdete v tématu "Train Large Person Group".

Poznámka

• • Algoritmus umožňuje identifikaci více než jedné tváře nezávisle 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 maximálně 248 tváří.
  • Vyšší kvalita obrazu tváře znamená lepší identifikaci přesnosti. Zvažte vysoce kvalitní tváře: přední, jasný a velikost obličeje je 200 × 200 pixelů (100 pixelů mezi očima) nebo větší.
  • Počet vrácených kandidátů je omezen maxNumOfCandidatesReturned a confidenceThreshold. Pokud není identifikována žádná osoba, budou vrácení kandidáti prázdným polem.
  • Zkuste najít podobné tváře, když potřebujete najít podobné tváře ze seznamu tváří nebo velkého seznamu tváří místo skupiny osob nebo velké skupiny osob.
  • Identifikátory faceId výrazu recognitionModel přidružené k tvářím dotazu by měly být stejné jako "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 výrazů faceId tváří v dotazu vytvořené funkcí Detect Každá z tváří se identifikuje nezávisle. Platný počet faceId je v rozsahu [1, 10].
largePersonGroupId	True	string	largePersonGroupId cílové skupiny velkých osob vytvořených pomocí možnosti Vytvořit velkou skupinu osob. Parametr personGroupId a largePersonGroupId by neměly být poskytovány 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í vnitřní prahovou hodnotu, aby se zlepšila přesnost dat scénáře. Všimněte si, že žádná záruka této prahové hodnoty nefunguje na jiných datech a po aktualizaci algoritmu.
maxNumOfCandidatesReturned		integer	Rozsah 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ěď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

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

Příklady

Identify from LargePersonGroup

Ukázkový požadavek

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
}

Ukázková odpověď

Stavový kód:

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 identifikaci hovoru.
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	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

IdentificationCandidate

Kandidát na identifikaci hovoru.

Name	Typ	Description
confidence	number	Hodnota spolehlivosti kandidáta Čím větší spolehlivost, tím podobnou. Rozsah mezi [0,1].
personId	string	personId kandidátské osoby.

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.