Udostępnij za pośrednictwem

Face Recognition Operations - Group

  • Odwołanie
Usługa:
Azure AI Services
Wersja interfejsu API:
v1.2-preview.1

Podziel twarze kandydatów na grupy na podstawie podobieństwa twarzy.

    • Dane wyjściowe to co najmniej jedna rozłączna grupa twarzy i niechlujna grupa. Grupa twarzy zawiera twarze, które mają podobny wygląd, często tej samej osoby. Grupy twarzy są klasyfikowane według rozmiaru grupy, czyli liczby twarzy. Zauważ, że twarze należące do tej samej osoby mogą być podzielone na kilka grup w wyniku.
    • MessyGroup to specjalna grupa twarzy zawierająca twarze, które nie mogą odnaleźć żadnej podobnej twarzy z oryginalnych twarzy. Niechlujna grupa nie pojawi się w wyniku, jeśli wszystkie twarze znalazły swoje odpowiedniki.
    • Interfejs API grup musi mieć co najmniej 2 twarze i co najmniej 1000. Zalecamy wypróbowanie "Verify Face To Face", jeśli masz tylko 2 twarze kandydata.
    • Identyfikatory faceId "recognitionModel" skojarzone z twarzami zapytania powinny być takie same.
POST {endpoint}/face/{apiVersion}/group

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
apiVersion
 path True

string

Wersja interfejsu API
endpoint
 path True

string

uri

Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).

Treść żądania

Nazwa Wymagane Typ Opis
faceIds True

string[]

Tablica kandydatów faceId utworzonych przez "Detect". Maksymalna liczba twarzy to 1000 twarzy.

Odpowiedzi

Nazwa Typ Opis
200 OK

GroupingResult

Pomyślne wywołanie zwraca co najmniej jedną grupę podobnych twarzy (rangę według rozmiaru grupy) i niechlujną grupę.
Other Status Codes

FaceErrorResponse

Nieoczekiwana odpowiedź na błąd.

Nagłówki

x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy w usłudze Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa Opis
https://cognitiveservices.azure.com/.default

Przykłady

Group Face IDs

Przykładowe żądanie

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"
  ]
}

Przykładowa odpowiedź

Kod stanu:
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"
  ]
}

Definicje

Nazwa Opis
FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.
GroupingResult

Treść odpowiedzi dla operacji twarzy grupy.

FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa Typ Opis
code

string

Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
message

string

Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa Typ Opis
error

FaceError

Obiekt błędu.

GroupingResult

Treść odpowiedzi dla operacji twarzy grupy.

Nazwa Typ Opis
groups

string[]

Partycja oryginalnych twarzy na podstawie podobieństwa twarzy. Grupy są klasyfikowane według liczby twarzy.
messyGroup

string[]

Tablica face ids twarzy, która nie może odnaleźć żadnych podobnych twarzy z oryginalnych twarzy.