Face List Operations - Train Large Face List

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Inviare un'attività di training per l'elenco dei volti di grandi dimensioni.

Il training è un passaggio cruciale che può essere usato solo da un elenco di volti di grandi dimensioni sottoposto a training da "Trova simili da un elenco di volti di grandi dimensioni".

L'attività di training è un'attività asincrona. Il tempo di training dipende dal numero di voci del viso in un elenco di visi di grandi dimensioni. Potrebbe essere in secondi o fino a mezz'ora per 1.000.000 visi. Per controllare il completamento del training, usare "Get Large Face List Training Status".

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
apiVersion	path	True	string	Versione API
endpoint	path	True	string uri	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://{nome-risorsa}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64. Criterio di espressione regolare: ^[a-z0-9-_]+$

Risposte

Nome	Tipo	Descrizione
202 Accepted		Una chiamata con esito positivo restituisce un corpo di risposta vuoto. Intestazioni operation-Location: string
Other Status Codes	FaceErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

Ocp-Apim-Subscription-Key

Chiave privata per la sottoscrizione di Viso di Intelligenza artificiale di Azure.

Tipo: apiKey
In: header

AADToken

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://api.example.com/oauth2/authorize
URL token: https://api.example.com/oauth2/token

Ambiti

Nome	Descrizione
https://cognitiveservices.azure.com/.default

Esempio

Train LargeFaceList

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

202

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

Definizioni

Nome	Descrizione
FaceError	Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Risposta contenente i dettagli dell'errore.

FaceError

Oggetto error. Per informazioni dettagliate sui codici di errore e i messaggi restituiti dal servizio Viso, vedere il collegamento seguente: https://aka.ms/face-error-codes-and-messages.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
message	string	Rappresentazione leggibile dell'errore.

FaceErrorResponse

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	FaceError	Oggetto error.