Person Group Operations - Create Person Group
Twórca nową grupę osób z określoną osobą PersonGroupId, nazwą, udostępnionym przez użytkownika userData i recognitionModel.
Grupa osób to kontener zawierający przekazane dane osoby, w tym funkcje rozpoznawania twarzy.
Po utworzeniu użyj polecenia "Twórca Person Group Person", aby dodać osoby do grupy, a następnie wywołaj metodę "Train Person Group", aby przygotować tę grupę do "Zidentyfikuj grupę osób".
Nie będzie przechowywany obraz. Tylko wyodrębnione funkcje twarzy i userData osoby będą przechowywane na serwerze, dopóki na serwerze nie zostanie wywołana opcja "Usuń osobę grupę osób" lub "Usuń grupę osób".
Należy określić element "recognitionModel", aby skojarzyć tę grupę osób. Wartość domyślna "recognitionModel" to "recognition_01", jeśli potrzebny jest najnowszy model, jawnie określ potrzebny model w tym parametrze. Nowe twarze dodane do istniejącej grupy osób będą używać modelu rozpoznawania, który jest już skojarzony z kolekcją. Nie można zaktualizować istniejących funkcji twarzy w grupie osób do funkcji wyodrębnionych przez inną wersję modelu rozpoznawania.
Uwaga
-
- Limit przydziału subskrypcji w warstwie Bezpłatna: 1000 osób Grupy. Każdy posiada maksymalnie 1000 osób.
- Limit przydziału subskrypcji warstwy S0: 1000 000 Osób Grupy. Każdy posiada do 10 000 osób.
- aby obsłużyć problem z identyfikacją twarzy na większą skalę, rozważ użycie grupy dużych osób.
PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
api
|
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). |
person
|
path | True |
string |
Identyfikator kontenera. Regex pattern: |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
name | True |
string |
Nazwa zdefiniowana przez użytkownika, maksymalna długość to 128. |
recognitionModel |
Recognition |
Element "recognitionModel" skojarzony z tą listą twarzy. Obsługiwane wartości "recognitionModel" obejmują wartości "recognition_01", "recognition_02, "recognition_03" i "recognition_04". Wartość domyślna to "recognition_01". Zaleca się stosowanie "recognition_04", ponieważ jego dokładność jest lepsza w przypadku twarzy noszących maski w porównaniu z "recognition_03", a jej ogólna dokładność jest lepsza w porównaniu z "recognition_01" i "recognition_02". |
|
userData |
string |
Opcjonalne dane zdefiniowane przez użytkownika. Długość nie powinna przekraczać 16 tys. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Żądanie zakończyło się pomyślnie. |
|
Other Status Codes |
Nieoczekiwana odpowiedź na błąd. Headers x-ms-error-code: string |
Zabezpieczenia
Ocp-Apim-Subscription-Key
Klucz tajny subskrypcji rozpoznawania twarzy usługi Azure AI.
Type:
apiKey
In:
header
AADToken
Przepływ OAuth2 usługi Azure Active Directory
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Nazwa | Opis |
---|---|
https://cognitiveservices.azure.com/.default |
Przykłady
Create PersonGroup
Sample Request
PUT {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id
{
"name": "your_person_group_name",
"userData": "your_user_data",
"recognitionModel": "recognition_01"
}
Sample Response
Definicje
Nazwa | Opis |
---|---|
Face |
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. |
Face |
Odpowiedź zawierająca szczegóły błędu. |
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 |
Obiekt błędu. |