Face List Operations - Get Large Face List

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Recuperare il valore largeFaceListId di un elenco di visi di grandi dimensioni, nome, userData e recognitionModel.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

Con parametri facoltativi:

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}?returnRecognitionModel={returnRecognitionModel}

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-_]+$
returnRecognitionModel	query		boolean	Restituisce o meno 'recognitionModel'. Il valore predefinito è false.

Risposte

Nome	Tipo	Descrizione
200 OK	LargeFaceList	Una chiamata con esito positivo restituisce le informazioni di Large Face List.
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

Get LargeFaceList

Esempio di richiesta

HTTP

GET {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id?returnRecognitionModel=True

Risposta di esempio

Codice di stato:

200

{
  "name": "your_large_face_list_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01",
  "largeFaceListId": "your_large_face_list_id"
}

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.
LargeFaceList	Elenco di visi di grandi dimensioni è un elenco di visi, fino a 1.000.000 visi.
RecognitionModel	Modello di riconoscimento per il viso.

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.

LargeFaceList

Elenco di visi di grandi dimensioni è un elenco di visi, fino a 1.000.000 visi.

Nome	Tipo	Descrizione
largeFaceListId	string	Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64.
name	string	Il nome definito dall'utente, la lunghezza massima è 128.
recognitionModel	RecognitionModel	Nome del modello di riconoscimento. Il modello di riconoscimento viene usato quando le funzionalità del viso vengono estratte e associate ai faceId rilevati.
userData	string	Dati facoltativi definiti dall'utente. La lunghezza non deve superare 16.000.

RecognitionModel

Modello di riconoscimento per il viso.

Nome	Tipo	Descrizione
recognition_01	string	Modello di riconoscimento predefinito per "Detect". Tutti i faceId creati prima del 2019 marzo sono associati a questo modello di riconoscimento.
recognition_02	string	Modello di riconoscimento rilasciato nel marzo 2019.
recognition_03	string	Modello di riconoscimento rilasciato nel maggio 2020.
recognition_04	string	Modello di riconoscimento rilasciato nel 2021 febbraio. È consigliabile usare questo modello di riconoscimento per migliorare l'accuratezza del riconoscimento.