Face Recognition Operations - Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.1-preview.1

Rozdělte kandidátské tváře do skupin na základě podobnosti tváří.

• • Výstupem je jedna nebo více oddělených skupin tváří a messyGroup. Skupina tváří obsahuje tváře, které vypadají podobně, často stejné osoby. Skupiny tváří jsou seřazené podle velikosti skupiny, tj. počtu tváří. Všimněte si, že tváře patřící stejné osobě můžou být ve výsledku rozdělené do několika skupin.
  • MessyGroup je speciální skupina tváří obsahující tváře, které nemůžou najít žádný podobný protějšek z původních tváří. MessyGroup se ve výsledku nezobrazí, pokud všechny tváře najdou své protějšky.
  • Rozhraní API skupiny potřebuje alespoň 2 kandidátské tváře a maximálně 1 000. Pokud máte pouze 2 kandidátské tváře, doporučujeme vyzkoušet možnost Ověření tváří v tvář.
  • Identifikátory faceId "recognitionModel" přidružené k tvářím dotazu by měly být stejné.

POST {endpoint}/face/{apiVersion}/group

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 kandidátských ID tváře vytvořené funkcí Detect. Maximální počet je 1 000 tváří.

Odpovědi

Name	Typ	Description
200 OK	GroupingResult	Úspěšné volání vrátí jednu nebo více skupin podobných tváří (pořadí podle velikosti skupiny) a messyGroup.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď. Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč pro vaše předplatné 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

Group Face IDs

Ukázkový požadavek

HTTP

POST {endpoint}/face/v1.1-preview.1/group

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

Ukázková odpověď

Stavový kód:

200

{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

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ě.
GroupingResult	Text odpovědi pro skupinovou operaci tváře.

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.

GroupingResult

Text odpovědi pro skupinovou operaci tváře.

Name	Typ	Description
groups	string[]	Rozdělení původních tváří na základě podobnosti tváří. Skupiny jsou seřazené podle počtu tváří.
messyGroup	string[]	Pole ID tváří, které nemůžou najít žádné podobné tváře z původních tváří.