API Viso

L'API Viso di Servizi cognitivi Microsoft consente di rilevare, identificare, analizzare, organizzare e contrassegnare i visi nelle foto.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Normale	Tutte le aree di Power Automate
App per la logica	Normale	Tutte le aree di App per la logica
Power Apps	Normale	Tutte le aree di Power Apps
Power Automate	Normale	Tutte le aree di Power Automate

Contatto
Nome	Microsoft
URL	Supporto di Microsoft LogicApps Supporto di Microsoft Power Automate Supporto di Microsoft Power Apps

Metadati del connettore
Editore	Microsoft
Sito web	https://azure.microsoft.com/services/cognitive-services/face/

Per usare questa integrazione, è necessaria una risorsa di Servizi cognitivi nel portale di Azure. Si otterrà un endpoint e una chiave per l'autenticazione delle applicazioni. Per stabilire una connessione, specificare la chiave account, l'URL del sito e selezionare Crea connessione. Per i costi operativi sulla connessione, vedere altre informazioni qui.

A questo punto è possibile iniziare a usare questa integrazione.

Connessione con Microsoft Entra ID

Per creare connessioni con Microsoft Entra ID, è necessario aggiungere il ruolo Utente servizi cognitivi all'account per accedere. Per usare questa connessione, è necessario immettere il sottodominio univoco associato alla risorsa servizi cognitivi nelle operazioni di supporto.

Operazioni non supportate con l'autenticazione di Microsoft Entra ID

Quando si usa l'autenticazione microsoft Entra ID sono supportate solo le azioni V2. Le azioni deprecate continueranno a funzionare con Access Key l'autenticazione, ma non riusciranno se usate con una connessione Microsoft Entra ID.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Chiave API	Chiave API	Tutte le aree geografiche	Condivisibile
Impostazione predefinita [DEPRECATO]	Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.	Tutte le aree geografiche	Non condivisibile

Chiave API

ID autenticazione: keyBasedAuth

Applicabile: tutte le aree

Chiave API

Si tratta di una connessione condivisibile. Se l'app per l'alimentazione viene condivisa con un altro utente, anche la connessione viene condivisa. Per altre informazioni, vedere Panoramica dei connettori per le app canvas - Power Apps | Microsoft Docs

Nome	TIPO	Description	Obbligatorio
Chiave dell'account	securestring	Chiave dell'account di Servizi cognitivi
URL sito	corda	URL sito radice (esempio: https://westus.api.cognitive.microsoft.com)

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
Chiave API	securestring	Chiave API	Vero
URL sito	corda	URL del sito radice (esempio: https://westus.api.cognitive.microsoft.com ). Se l'URL del sito non specificato verrà impostato su 'https://westus.api.cognitive.microsoft.com'.

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	1200	60 secondi

Azioni

Aggiungere l'elenco viso a viso (V2)	Aggiungere l'elenco viso a viso.
Aggiungere un viso all'elenco dei volti	Aggiungere l'elenco viso a viso.
Aggiungere un viso di persona	Aggiungere un viso rappresentativo a una persona per l'identificazione.
Aggiungere un viso di persona (V2)	Aggiungere un viso rappresentativo a una persona per l'identificazione.
Creare un elenco di visi	Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome e un userData facoltativo.
Creare un elenco di visi (V2)	Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome e un userData facoltativo.
Creare un gruppo di persone	Creare un nuovo gruppo di persone con personGroupId, nome e userData specificati dall'utente.
Creare un gruppo di persone (V2)	Creare un nuovo gruppo di persone con personGroupId, nome e userData specificati dall'utente.
Creare una persona	Creare una nuova persona in un gruppo di persone specificato.
Creare una persona (V2)	Creare una nuova persona in un gruppo di persone specificato.
Ottenere un elenco di visi	Recuperare le informazioni di un elenco di visi, tra cui faceListId, nome, userData e visi nell'elenco dei volti.
Ottenere un elenco di visi (V2)	Recuperare le informazioni di un elenco di visi, tra cui faceListId, nome, userData e visi nell'elenco dei volti.
Ottenere un gruppo di persone	Recuperare le informazioni di un gruppo di persone, inclusi il nome e userData.
Ottenere un gruppo di persone (V2)	Recuperare le informazioni di un gruppo di persone, inclusi il nome e userData.
Ottenere un viso di persona	Recuperare informazioni su un viso persistente specificato da persistedFaceId, personId e il relativo personGroupId.
Ottenere un viso di persona (V2)	Recuperare informazioni su un viso persistente specificato da persistedFaceId, personId e il relativo personGroupId.
Ottenere una persona	Recuperare le informazioni di una persona, inclusi i visi salvati in modo permanente, il nome e userData registrati.
Ottenere una persona (V2)	Recuperare le informazioni di una persona, inclusi i visi salvati in modo permanente, il nome e userData registrati.
Rilevare i visi	Rilevare i visi umani in un'immagine e restituire posizioni dei visi e, facoltativamente, con faceId, punti di riferimento e attributi.
Rilevare i visi (V2)	Rilevare i visi umani in un'immagine e restituire posizioni dei visi e, facoltativamente, con faceId, punti di riferimento e attributi.
Trova persona dal viso	Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.
Trova persona dal viso (V2)	Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.

Aggiungere l'elenco viso a viso (V2)

ID operazione:

AddFaceToFaceListV2

Aggiungere l'elenco viso a viso.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
URL immagine	url		string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP
Viso di destinazione	targetFace		string	Rettangolo del viso per specificare il viso di destinazione da aggiungere a una persona, nel formato targetFace=left,top,width,height
Dati utente	userData		string	Dati specificati dall'utente sul viso di destinazione da aggiungere per qualsiasi scopo. La lunghezza massima è di 1 KB.
ID elenco visi	faceListId	True	string	Il carattere valido è una lettera minuscola o una cifra oppure '-' o '_', la lunghezza massima è 64.

Restituisce

Corpo

AddPersonFaceResponse

Aggiungere un viso all'elenco dei volti

ID operazione:

AddFaceToFaceList

Aggiungere l'elenco viso a viso.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
URL immagine	url		string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP
Viso di destinazione	targetFace		string	Rettangolo del viso per specificare il viso di destinazione da aggiungere a una persona, nel formato targetFace=left,top,width,height
Dati utente	userData		string	Dati specificati dall'utente sul viso di destinazione da aggiungere per qualsiasi scopo. La lunghezza massima è di 1 KB.
ID elenco visi	faceListId	True	string	Il carattere valido è una lettera minuscola o una cifra oppure '-' o '_', la lunghezza massima è 64.

Restituisce

Corpo

AddPersonFaceResponse

Aggiungere un viso di persona

ID operazione:

AddPersonFace

Aggiungere un viso rappresentativo a una persona per l'identificazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	Gruppo di persone
ID persona	personId	True	string	Persona di destinazione a cui viene aggiunto il viso.
URL immagine	url	True	string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP
Viso di destinazione	targetFace		string	Rettangolo del viso per specificare il viso di destinazione da aggiungere a una persona, nel formato targetFace=left,top,width,height
Dati utente	userData		string	Dati specificati dall'utente sul viso di destinazione da aggiungere per qualsiasi scopo. La lunghezza massima è di 1 KB.

Restituisce

Corpo

AddPersonFaceResponse

Aggiungere un viso di persona (V2)

ID operazione:

AddPersonFaceV2

Aggiungere un viso rappresentativo a una persona per l'identificazione.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	Gruppo di persone
ID persona	personId	True	string	Persona di destinazione a cui viene aggiunto il viso.
URL immagine	url	True	string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP
Viso di destinazione	targetFace		string	Rettangolo del viso per specificare il viso di destinazione da aggiungere a una persona, nel formato targetFace=left,top,width,height
Dati utente	userData		string	Dati specificati dall'utente sul viso di destinazione da aggiungere per qualsiasi scopo. La lunghezza massima è di 1 KB.

Restituisce

Corpo

AddPersonFaceResponse

Creare un elenco di visi

ID operazione:

CreateFaceList

Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome e un userData facoltativo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elenco visi	faceListId	True	string	Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64
Nome elenco visi	name	True	string	Nome dell'elenco dei visi creato, la lunghezza massima è 128.
Dati utente	userData		string	Dati facoltativi definiti dall'utente per l'elenco dei visi. La lunghezza non deve superare i 16 KB.

Creare un elenco di visi (V2)

ID operazione:

CreateFaceListV2

Creare un elenco di visi vuoto con faceListId specificato dall'utente, un nome e un userData facoltativo.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID elenco visi	faceListId	True	string	Il carattere valido è una lettera in lettere minuscole o cifre o '-' o '_', la lunghezza massima è 64
Nome elenco visi	name	True	string	Nome dell'elenco dei visi creato, la lunghezza massima è 128.
Dati utente	userData		string	Dati facoltativi definiti dall'utente per l'elenco dei visi. La lunghezza non deve superare i 16 KB.

Creare un gruppo di persone

ID operazione:

CreatePersonGroup

Creare un nuovo gruppo di persone con personGroupId, nome e userData specificati dall'utente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	NEW Person Group ID (i caratteri validi includono numeri, lettere inglesi in lettere minuscole, '-' e '_')
Nome	name	True	string	Nome visualizzato del gruppo di persone. La lunghezza massima è 128.
Dati utente	userData		string	Dati forniti dall'utente collegati al gruppo di persone. Il limite di dimensioni è 16 KB.

Creare un gruppo di persone (V2)

ID operazione:

CreatePersonGroupV2

Creare un nuovo gruppo di persone con personGroupId, nome e userData specificati dall'utente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	NEW Person Group ID (i caratteri validi includono numeri, lettere inglesi in lettere minuscole, '-' e '_')
Nome	name	True	string	Nome visualizzato del gruppo di persone. La lunghezza massima è 128.
Dati utente	userData		string	Dati forniti dall'utente collegati al gruppo di persone. Il limite di dimensioni è 16 KB.

Creare una persona

ID operazione:

CreatePerson

Creare una nuova persona in un gruppo di persone specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone di destinazione per creare la persona.
Nome	name	True	string	Nome visualizzato della persona di destinazione. La lunghezza massima è 128.
Dati utente	userData		string	Campi facoltativi per i dati forniti dall'utente associati a una persona. Il limite di dimensioni è 16 KB.

Restituisce

Corpo

CreatePersonResponse

Creare una persona (V2)

ID operazione:

CreatePersonV2

Creare una nuova persona in un gruppo di persone specificato.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone di destinazione per creare la persona.
Nome	name	True	string	Nome visualizzato della persona di destinazione. La lunghezza massima è 128.
Dati utente	userData		string	Campi facoltativi per i dati forniti dall'utente associati a una persona. Il limite di dimensioni è 16 KB.

Restituisce

Corpo

CreatePersonResponse

Ottenere un elenco di visi

ID operazione:

GetFaceList

Recuperare le informazioni di un elenco di visi, tra cui faceListId, nome, userData e visi nell'elenco dei volti.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID elenco visi	faceListId	True	string	faceListId dell'elenco di visi di destinazione.

Restituisce

Corpo

GetFaceListResponse

Ottenere un elenco di visi (V2)

ID operazione:

GetFaceListV2

Recuperare le informazioni di un elenco di visi, tra cui faceListId, nome, userData e visi nell'elenco dei volti.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID elenco visi	faceListId	True	string	faceListId dell'elenco di visi di destinazione.

Restituisce

Corpo

GetFaceListResponse

Ottenere un gruppo di persone

ID operazione:

GetPersonGroup

Recuperare le informazioni di un gruppo di persone, inclusi il nome e userData.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	ID gruppo di persone di destinazione.

Restituisce

Corpo

GetPersonGroupResponse

Ottenere un gruppo di persone (V2)

ID operazione:

GetPersonGroupV2

Recuperare le informazioni di un gruppo di persone, inclusi il nome e userData.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	ID gruppo di persone di destinazione.

Restituisce

Corpo

GetPersonGroupResponse

Ottenere un viso di persona

ID operazione:

GetPersonFace

Recuperare informazioni su un viso persistente specificato da persistedFaceId, personId e il relativo personGroupId.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone contenente la persona di destinazione.
ID persona	personId	True	string	Specifica della persona di destinazione a cui appartiene il viso.
ID viso persistente	persistedFaceId	True	string	PersistedFaceId del viso persistente della destinazione della persona.

Restituisce

Corpo

GetPersonFaceResponse

Ottenere un viso di persona (V2)

ID operazione:

GetPersonFaceV2

Recuperare informazioni su un viso persistente specificato da persistedFaceId, personId e il relativo personGroupId.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone contenente la persona di destinazione.
ID persona	personId	True	string	Specifica della persona di destinazione a cui appartiene il viso.
ID viso persistente	persistedFaceId	True	string	PersistedFaceId del viso persistente della destinazione della persona.

Restituisce

Corpo

GetPersonFaceResponse

Ottenere una persona

ID operazione:

GetPerson

Recuperare le informazioni di una persona, inclusi i visi salvati in modo permanente, il nome e userData registrati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone contenente la persona di destinazione.
ID persona	personId	True	string	Specifica della persona di destinazione.

Restituisce

Corpo

GetPersonResponse

Ottenere una persona (V2)

ID operazione:

GetPersonV2

Recuperare le informazioni di una persona, inclusi i visi salvati in modo permanente, il nome e userData registrati.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
ID gruppo di persone	personGroupId	True	string	Specifica del gruppo di persone contenente la persona di destinazione.
ID persona	personId	True	string	Specifica della persona di destinazione.

Restituisce

Corpo

GetPersonResponse

Rilevare i visi

ID operazione:

Detect

Rilevare i visi umani in un'immagine e restituire posizioni dei visi e, facoltativamente, con faceId, punti di riferimento e attributi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
URL immagine	url	True	string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP

Restituisce

Elementi

DetectResponse

Rilevare i visi (V2)

ID operazione:

DetectV2

Rilevare i visi umani in un'immagine e restituire posizioni dei visi e, facoltativamente, con faceId, punti di riferimento e attributi.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
URL immagine	url	True	string	L'immagine deve essere JPEG, PNG, GIF(il primo fotogramma) o BMP

Restituisce

Elementi

DetectResponse

Trova persona dal viso

ID operazione:

Verify

Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Face Id	faceId	True	string	FaceId univoco del viso rilevato. Scadrà 24 ore dopo la chiamata di rilevamento.
ID gruppo di persone	personGroupId	True	string	ID gruppo di persone creato nell'API Viso - Azione Crea gruppo persone.
ID persona	personId	True	string	ID persona creato nell'API Viso - Azione Crea persona.

Restituisce

Corpo

VerifyResponse

Trova persona dal viso (V2)

ID operazione:

VerifyV2

Verificare se due visi appartengono a una stessa persona o se un viso appartiene a una persona.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Sottodominio o area della risorsa	subdomain	True	string	Sottodominio o area geografica di Azure (ad esempio westus)
Face Id	faceId	True	string	FaceId univoco del viso rilevato. Scadrà 24 ore dopo la chiamata di rilevamento.
ID gruppo di persone	personGroupId	True	string	ID gruppo di persone creato nell'API Viso - Azione Crea gruppo persone.
ID persona	personId	True	string	ID persona creato nell'API Viso - Azione Crea persona.

Restituisce

Corpo

VerifyResponse

Definizioni

DetectResponse

Nome	Percorso	Tipo	Descrizione
Face Id	faceId	string	FaceId univoco del viso rilevato. Scadrà 24 ore dopo la chiamata di rilevamento.
In alto	faceRectangle.top	integer	Parametri di un'area rettangolo per la posizione del viso nell'immagine.
Sinistra	faceRectangle.left	integer	Parametri di un'area rettangolo per la posizione del viso nell'immagine.
Larghezza	faceRectangle.width	integer	Parametri di un'area rettangolo per la posizione del viso nell'immagine.
Altezza	faceRectangle.height	integer	Parametri di un'area rettangolo per la posizione del viso nell'immagine.
Pupilla sinistra X	faceLandmarks.pupilLeft.x	float	Coordinata x della pupilla sinistra.
Pupillo sinistro Y	faceLandmarks.pupilLeft.y	float	Coordinata y della pupilla sinistra.
Pupilla destra X	faceLandmarks.pupilRight.x	float	Coordinata x della pupilla destra.
Pupillo destro Y	faceLandmarks.pupilRight.y	float	Coordinata y della pupilla destra.
Punta del naso X	faceLandmarks.noseTip.x	float	Coordinata x della punta del naso.
Punta del naso Y	faceLandmarks.noseTip.y	float	Coordinata y della punta del naso.
Bocca sinistra X	faceLandmarks.mouthLeft.x	float	Coordinata x per il lato sinistro della bocca.
Bocca sinistra Y	faceLandmarks.mouthLeft.y	float	Coordinata y per il lato sinistro della bocca.
Bocca destra X	faceLandmarks.mouthRight.x	float	Coordinata x per il lato destro della bocca.
Bocca destra Y	faceLandmarks.mouthRight.y	float	Coordinata y per il lato destro della bocca.
Sopracciglia sinistra esterna X	faceLandmarks.eyebrowLeftOuter.x	float	Coordinata x per il lato esterno della sopracciglia sinistra.
Sopracciglia sinistra esterna Y	faceLandmarks.eyebrowLeftOuter.y	float	Coordinata y per il lato esterno della sopracciglia sinistra.
Eybrow A sinistra interna X	faceLandmarks.eyebrowLeftInner.x	float	Coordinata x per il lato interno della sopracciglia sinistra.
Sopracciglia sinistra interna Y	faceLandmarks.eyebrowLeftInner.y	float	Coordinata y per il lato interno della sopracciglia sinistra.
Occhio sinistro esterno X	faceLandmarks.eyeLeftOuter.x	float	Coordinata x per il lato esterno dell'occhio sinistro.
Occhio sinistro esterno Y	faceLandmarks.eyeLeftOuter.y	float	Coordinata y per il lato esterno dell'occhio sinistro.
Angolo superiore sinistro X	faceLandmarks.eyeLeftTop.x	float	Coordinata x per la parte superiore dell'occhio sinistro.
Sopra l'occhio sinistro Y	faceLandmarks.eyeLeftTop.y	float	Coordinata y per la parte superiore dell'occhio sinistro.
Inferiore dell'occhio sinistro X	faceLandmarks.eyeLeftBottom.x	float	Coordinata x per la parte inferiore dell'occhio sinistro.
Inferiore dell'occhio sinistro Y	faceLandmarks.eyeLeftBottom.y	float	Coordinata y per la parte inferiore dell'occhio sinistro.
Occhio sinistro interno X	faceLandmarks.eyeLeftInner.x	float	Coordinata x per il lato interno dell'occhio sinistro.
Occhio sinistro interno Y	faceLandmarks.eyeLeftInner.y	float	Coordinata y per il lato interno dell'occhio sinistro.
Inner Right Eybrow X	faceLandmarks.eyebrowRightInner.x	float	Coordinata x per il lato interno della sopracciglia destra.
Sopracciglia destra interna Y	faceLandmarks.eyebrowRightInner.y	float	Coordinata y per il lato interno della sopracciglia destra.
Sopracciglia destra esterna X	faceLandmarks.eyebrowRightOuter.x	float	Coordinata x per il lato esterno della sopracciglia destra.
Sopracciglia destra esterna Y	faceLandmarks.eyebrowRightOuter.y	float	Coordinata y per il lato esterno della sopracciglia destra.
Occhio destro interno X	faceLandmarks.eyeRightInner.x	float	Coordinata x per il lato interno dell'occhio destro.
Occhio destro interno Y	faceLandmarks.eyeRightInner.y	float	Coordinata y per il lato interno dell'occhio destro.
Sopra l'occhio destro X	faceLandmarks.eyeRightTop.x	float	Coordinata x per la parte superiore dell'occhio destro.
Sopra l'occhio destro Y	faceLandmarks.eyeRightTop.y	float	Coordinata y per la parte superiore dell'occhio destro.
Inferiore dell'occhio destro X	faceLandmarks.eyeRightBottom.x	float	Coordinata x per la parte inferiore dell'occhio destro.
Inferiore dell'occhio destro Y	faceLandmarks.eyeRightBottom.y	float	Coordinata y per la parte inferiore dell'occhio destro.
Occhio destro esterno X	faceLandmarks.eyeRightOuter.x	float	Coordinata x per il lato esterno dell'occhio destro.
Occhio destro esterno Y	faceLandmarks.eyeRightOuter.y	float	Coordinata y per il lato esterno dell'occhio destro.
Radice del naso sinistro X	faceLandmarks.noseRootLeft.x	float	Coordinata x per il lato sinistro della radice del naso.
Radice del naso sinistro Y	faceLandmarks.noseRootLeft.y	float	Coordinata y per il lato sinistro della radice del naso.
Radice destra del naso X	faceLandmarks.noseRootRight.x	float	Coordinata x per il lato destro della radice del naso.
Radice del naso destro Y	faceLandmarks.noseRootRight.y	float	Coordinata y per il lato destro della radice del naso.
Sopra l'altare del naso sinistro X	faceLandmarks.noseLeftAlarTop.x	float	Coordinata x per la parte superiore dell'altare del naso sinistro.
Sopra l'altare del naso sinistro Y	faceLandmarks.noseLeftAlarTop.y	float	Coordinata y per la parte superiore dell'altare del naso sinistro.
Sopra l'altare del naso destro X	faceLandmarks.noseRightAlarTop.x	float	Coordinata x per la parte superiore dell'altare del naso destro.
Sopra l'altare del naso destro Y	faceLandmarks.noseRightAlarTop.y	float	Coordinata y per la parte superiore dell'altare del naso destro.
Punta dell'altare sinistro del naso fuori X	faceLandmarks.noseLeftAlarOutTip.x	float	Coordinata x per la punta dell'altare del naso sinistro.
Punta dell'altare sinistro del naso fuori Y	faceLandmarks.noseLeftAlarOutTip.y	float	Coordinata y per la punta dell'altare del naso sinistro/
Punta dell'altare destro del naso fuori X	faceLandmarks.noseRightAlarOutTip.x	float	Coordinata x per la punta dell'altare del naso destro.
Punta dell'altare destro del naso fuori Y	faceLandmarks.noseRightAlarOutTip.y	float	Coordinata y per la punta dell'altare del naso destro.
Superiore del labbro superiore X	faceLandmarks.upperLipTop.x	float	Coordinata x per la parte superiore del labbro superiore.
Parte superiore del labbro superiore Y	faceLandmarks.upperLipTop.y	float	Coordinata y per la parte superiore del labbro superiore.
Inferiore del labbro superiore X	faceLandmarks.upperLipBottom.x	float	Coordinata x per il fondo del labbro superiore.
Fondo del labbro superiore Y	faceLandmarks.upperLipBottom.y	float	Coordinata y per il fondo del labbro superiore.
Top of Under Lip X	faceLandmarks.underLipTop.x	float	Coordinata x per la parte superiore del labbro.
Top of Under Lip Y	faceLandmarks.underLipTop.y	float	Coordinata y per la parte superiore del labbro.
Fondo sotto labbro X	faceLandmarks.underLipBottom.x	float	Coordinata x per il fondo del labbro.
Fondo sotto labbro Y	faceLandmarks.underLipBottom.y	float	Coordinata y per il fondo del labbro.
Inclinazione della posizione della testa	faceAttributes.headPose.pitch	float	Campo riservato, restituisce sempre 0.
Rotolo posizione testa	faceAttributes.headPose.roll	float	Rotolo della posizione della testa.
Testa Posa Yaw	faceAttributes.headPose.yaw	float	Yaw della posa della testa.
Occhiali	faceAttributes.glasses	string	Tipo di occhiali.

AddPersonFaceResponse

Nome	Percorso	Tipo	Descrizione
ID viso persistente	persistedFaceId	string

GetPersonGroupResponse

Nome	Percorso	Tipo	Descrizione
ID gruppo di persone	personGroupId	string
Nome	name	string
userData	userData	string

GetFaceListResponse

Nome	Percorso	Tipo	Descrizione
Volti persistenti	persistedFaces	array of object
ID viso persistente	persistedFaces.persistedFaceId	string	ID del viso.
Dati utente	persistedFaces.userData	string	Dati forniti dall'utente collegati a ogni viso.
ID elenco visi	faceListId	string	faceListId dell'elenco di visi di destinazione.
Nome	name	string	Nome visualizzato dell'elenco dei visi.
Dati utente	userData	string	Dati forniti dall'utente collegati all'elenco dei volti.

GetPersonFaceResponse

Nome	Percorso	Tipo	Descrizione
ID viso persistente	persistedFaceId	string
userData	userData	string

CreatePersonResponse

Nome	Percorso	Tipo	Descrizione
ID persona	personId	string

GetPersonResponse

Nome	Percorso	Tipo	Descrizione
ID persona	personId	string
Id viso persistenti	persistedFaceIds	array of object
ID viso persistente	persistedFaceIds.persistedFaceId	string
Nome	name	string
Dati utente	userData	string

VerifyResponse

Nome	Percorso	Tipo	Descrizione
È identico	isIdentical	boolean	Vero se le due facce appartengono alla stessa persona o il volto appartiene alla persona, altrimenti falso.
Fiducia	confidence	float	Un numero indica la somiglianza e l'affidabilità se due volti appartengono alla stessa persona o se il volto appartiene alla persona.