Face Recognition Operations - Identify From Dynamic Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Identifikace 1:N k nalezení nejbližších shod konkrétní osoby dotazu z dynamické skupiny osob.
Pro každou tvář v poli FaceIds vypočítá rozpoznávání tváře podobnosti mezi tváří dotazu a všemi tvářemi ve skupině dynamických osob (dané dynamicPersonGroupId) a vrátí kandidátské osoby pro danou tvář seřazené podle spolehlivosti podobnosti.

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
dynamicPersonGroupId	True	string	DynamicPersonGroupId cílové skupiny PersonDirectory DynamicPersonGroup, která se má shodovat.
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].
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 DynamicPersonGroup

Ukázkový požadavek

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "dynamicPersonGroupId": "your_dynamic_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.