Person Group Operations - Create Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Twórca nową grupę dużych osób z określoną przez użytkownika wartością largePersonGroupId, name, optional userData i recognitionModel.
Grupa dużych osób to kontener przechowujący przekazane dane osoby, w tym funkcje rozpoznawania twarzy. Może pomieścić do 1000 000 jednostek.

Po utworzeniu użyj polecenia "Twórca Osoba grupy dużej osoby", aby dodać osobę do grupy, i wywołaj polecenie "Train Large Person Group" (Trenowanie grupy dużych osób), aby przygotować tę grupę do "Identyfikowanie z dużej grupy osób".

Nie będzie przechowywany żaden obraz. Tylko wyodrębnione funkcje twarzy i userData osoby będą przechowywane na serwerze do momentu wywołania "Usuń osobę z grupy dużej osoby" lub "Usuń grupę dużej osoby".

Należy określić element "recognitionModel", aby skojarzyć z tą grupą dużych osób. Wartość domyślna elementu "recognitionModel" to "recognition_01", jeśli potrzebny jest najnowszy model, określ jawnie wymagany model w tym parametrze. Nowe twarze dodane do istniejącej grupy dużych osób będą używać modelu rozpoznawania, który jest już skojarzony z kolekcją. Istniejących funkcji twarzy w grupie dużej osoby nie można zaktualizować do funkcji wyodrębnionych przez inną wersję modelu rozpoznawania.

Uwaga

• • Limit przydziału subskrypcji w warstwie Bezpłatna: 1000 dużych osób Grupy.
  • Limit przydziału subskrypcji warstwy S0: 1 000 000 dużych osób Grupy.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

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).
largePersonGroupId	path	True	string	Identyfikator kontenera. Regex pattern: ^[a-z0-9-_]+$

Treść żądania

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa zdefiniowana przez użytkownika, maksymalna długość to 128.
recognitionModel		RecognitionModel	Element "recognitionModel" skojarzony z tą listą twarzy. Obsługiwane wartości "recognitionModel" obejmują "recognition_01", "recognition_02, "recognition_03" i "recognition_04". Wartość domyślna to "recognition_01". Zaleca się "recognition_04", ponieważ jego dokładność zwiększa się na twarzach w maskach w porównaniu z "recognition_03", a jego 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	FaceErrorResponse	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 LargePersonGroup

Sample Request

HTTP

PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Sample Response

Status code:

200

Definicje

Nazwa	Opis
FaceError	Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpowiedź zawierająca szczegóły błędu.

FaceError

Obiekt error. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, skorzystaj z następującego linku: 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 error.