Face Recognition Operations - Identify From Person Directory

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Identifikace 1:N, která najde nejbližší shody konkrétní osoby dotazu z pole id osob adresáře osob.
Pro každou tvář v poli FaceIds vypočítá rozpoznávání tváře podobnosti mezi tváří dotazu a všemi tvářemi v adresáři osob (podle id osob) a vrátí kandidátské osoby pro danou tvář seřazenou podle spolehlivosti podobnosti. Předání personId s polem s jedním prvkem "*" může provést operaci přes celý adresář osob.

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.
  • Operace Identifikace se může shodovat pouze s tvářemi získanými pomocí stejného modelu rozpoznávání, který je přidružený k tvářím dotazu.

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].
personIds	True	string[]	Pole identifikátorů personId vytvořených v adresáři person "Create Person" (Vytvořit osobu). Platný počet ID osoby je v rozsahu [1,30].
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 PersonDirectory

Ukázkový požadavek

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ],
  "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.