Person Group Operations - Train Large Person Group

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

Prześlij zadanie szkoleniowe grupy dużej osoby. Trenowanie to kluczowy krok, który może być używany tylko przez grupę "Identyfikowanie z grupy dużych osób".
Zadanie trenowania jest zadaniem asynchronicznym. Czas szkolenia zależy od liczby wpisów osób i ich twarzy w grupie dużej osoby. Może to być w ciągu kilku sekund lub do pół godziny dla 1000 000 osób. Aby sprawdzić stan szkolenia, użyj polecenia "Pobierz stan trenowania grupy dużej osoby".

POST {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}/train

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. Wzorzec wyrażenia regularnego: ^[a-z0-9-_]+$

Odpowiedzi

Nazwa	Typ	Opis
202 Accepted		Pomyślne wywołanie zwraca pustą treść odpowiedzi. Nagłówki operation-Location: string
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

Train LargePersonGroup

Przykładowe żądanie

HTTP

POST {endpoint}/face/v1.2-preview.1/largepersongroups/your_large_person_group_id/train

Przykładowa odpowiedź

Kod stanu:

202

operation-Location: https://contoso.com/operationstatus

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.

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.