Face List Operations - Train Large Face List

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Odešlete trénovací úkol pro velký seznam tváří.

Trénování je zásadní krok, který může použít jen trénovaný velký seznam tváří v části Najít podobné z velkého seznamu tváří.

Trénovací úkol je asynchronní úkol. Doba trénování závisí na počtu položek tváře ve velkém seznamu tváří. Může to být v sekundách nebo až půl hodiny na 1 000 000 tváří. Pokud chcete zkontrolovat dokončení trénování, použijte "Get Large Face List Training Status".

POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/train

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Platný znak je písmeno v malých písmenech nebo číslici nebo číslici nebo "-" nebo '_', maximální délka je 64. Vzor regulárního výrazu: ^[a-z0-9-_]+$

Odpovědi

Name	Typ	Description
202 Accepted		Úspěšné volání vrátí prázdný text odpovědi. Hlavičky operation-Location: string
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name	Description
https://cognitiveservices.azure.com/.default

Příklady

Train LargeFaceList

Ukázkový požadavek

HTTP

POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/train

Ukázková odpověď

Stavový kód:

202

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

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.