Person Group Operations - Train Person Group

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

Prześlij zadanie szkoleniowe grupy osób. Trenowanie to kluczowy krok, który może być używany tylko przez grupę "Zidentyfikuj grupę osób".
Zadanie trenowania jest zadaniem asynchronicznym. Czas szkolenia zależy od liczby wpisów osób i ich twarzy w grupie osób. Może to potrwać kilka sekund do minut. Aby sprawdzić stan szkolenia, użyj pozycji "Pobierz stan trenowania grupy osób".

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/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).
personGroupId	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 PersonGroup

Przykładowe żądanie

HTTP

POST {endpoint}/face/v1.2-preview.1/persongroups/your_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.