Person Directory Operations - Get Person Face

Servizio:

Azure AI Services

Versione API:

v1.2-preview.1

Recuperare le informazioni sul viso della persona. Il viso della persona persistente viene specificato dal relativo personId. recognitionModel e persistedFaceId.

GET {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}

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).
persistedFaceId	path	True	string uuid	ID viso del viso.
personId	path	True	string uuid	ID persona della persona.
recognitionModel	path	True	RecognitionModel	'recognitionModel' associato ai visi.

Risposte

Nome	Tipo	Descrizione
200 OK	PersonDirectoryFace	Una chiamata con esito positivo restituisce le informazioni sul viso persistenti (persistedFaceId e userData).
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 Face from PersonDirectory Person

Esempio di richiesta

HTTP

GET {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Risposta di esempio

Codice di stato:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

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.
PersonDirectoryFace	Risorsa viso per la persona della directory delle persone.
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.

PersonDirectoryFace

Risorsa viso per la persona della directory delle persone.

Nome	Tipo	Descrizione
persistedFaceId	string	ID viso del viso.
userData	string	Dati forniti dall'utente collegati al viso. Il limite di lunghezza è 1K.

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.