Face Recognition Operations - Group

  • Reference
Služba:
Azure AI Services
Verze rozhraní API:
v1.2-preview.1

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

    • Výstupem je jedna nebo více oddělených skupin tváří a messyGroup. Skupina tváří obsahuje tváře, které mají podobné vzhled, často stejné osoby. Skupiny tváří jsou seřazené podle velikosti skupiny, tj. počtu tváří. Všimněte si, že ve výsledku můžou být tváře patřící stejné osobě rozdělené do několika skupin.
    • MessyGroup je speciální skupina tváří obsahující tváře, které nemohou najít žádnou podobnou protějškovou tvář z původních tváří. MessyGroup se ve výsledku nezobrazí, pokud všechny tváře našly své protějšky.
    • Rozhraní API skupiny potřebuje minimálně 2 kandidátské tváře a maximálně 1 000. Doporučujeme vyzkoušet možnost Ověřit tvář na tvář, pokud máte pouze 2 kandidátské tváře.
    • Identifikátory faceId výrazu 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 faceId vytvořených funkcí Detect Maximum 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áří (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íč 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

Group Face IDs

Ukázkový požadavek

POST {endpoint}/face/v1.2-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 operaci skupinové 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

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.

GroupingResult

Text odpovědi pro operaci skupinové tváře.

Name Typ Description
groups

string[]

Oddíl původních tváří na základě podobnosti tváře. Skupiny jsou seřazené podle počtu tváří.
messyGroup

string[]

Id tváře pole tváří, které nemohou najít žádné podobné tváře z původních tváří.