Informazioni sull'API Viso di AzureWhat is the Azure Face API?

L'API Viso di Servizi cognitivi di Azure offre gli algoritmi per rilevare, riconoscere e analizzare i visi umani nelle immagini.The Azure Cognitive Services Face API provides algorithms that are used to detect, recognize, and analyze human faces in images. La possibilità di elaborare le informazioni relative ai visi umani è importante in molti scenari di software diversi,The ability to process human face information is important in many different software scenarios. tra cui sicurezza, interfaccia utente naturale, analisi e gestione del contenuto di immagini, app per dispositivi mobili e robotica.Example scenarios are security, natural user interface, image content analysis and management, mobile apps, and robotics.

L'API Viso offre diverse funzioni,The Face API provides several different functions. descritte nelle sezioni seguenti.Each function is outlined in the following sections. Proseguire la lettura per altre informazioni su ogni funzione.Read on to learn more about them.

Rilevamento del visoFace detection

L'API Viso rileva i visi umani in un'immagine e restituisce le coordinate del rettangolo delle posizioni corrispondenti.The Face API detects human faces in an image and returns the rectangle coordinates of their locations. Facoltativamente, la funzionalità di rilevamento viso può estrarre una serie di attributi relativi al viso,Optionally, face detection can extract a series of face-related attributes. come posa, posizione della testa, sesso, età, emozione, barba/baffi e occhiali.Examples are head pose, gender, age, emotion, facial hair, and glasses.

Nota

La funzionalità di rilevamento viso è disponibile anche tramite l'API Visione artificiale.The face detection feature is also available through the Computer Vision API. Se però si vogliono eseguire altre operazioni con i dati relativi ai visi, è preferibile usare l'API Viso, ovvero il servizio descritto in questo articolo.If you want to do further operations with face data, use the Face API, which is the service discussed in this article.

Immagine di una donna e di un uomo, con rettangoli disegnati intorno ai visi e informazioni su età e sesso

Per altre informazioni sul rilevamento del viso, vedere l'articolo che illustra i concetti relativi al rilevamento del viso.For more information on face detection, see the Face detection concepts article. Consultare inoltre la documentazione di riferimento dell'API di rilevamento.Also see the Detect API reference documentation.

Verifica del visoFace verification

L'API di verifica esegue un'autenticazione su due visi rilevati o un'autenticazione da un viso rilevato a un oggetto persona.The Verify API performs an authentication against two detected faces or from one detected face to one person object. In pratica, valuta se due visi appartengano alla stessa persona.Practically, it evaluates whether two faces belong to the same person. Questo è potenzialmente utile negli scenari di sicurezza.This capability is potentially useful in security scenarios. Per altre informazioni, vedere l'articolo che illustra i concetti relativi al riconoscimento del viso o consultare la documentazione di riferimento dell'API di verifica.For more information, see the Face recognition concepts guide or the Verify API reference documentation.

Individuazione di visi similiFind similar faces

L'API di individuazione di visi simili confronta un viso di destinazione con un set di visi candidati e individua un set più piccolo di visi simili a quello di destinazione.The Find Similar API compares a target face with a set of candidate faces to find a smaller set of faces that look similar to the target face. Sono supportate due modalità di utilizzo, ovvero matchPerson e matchFace.Two working modes, matchPerson and matchFace, are supported. La modalità matchPerson restituisce visi simili dopo aver filtrato in base all'appartenenza alla stessa persona usando l'API di verifica.The matchPerson mode returns similar faces after it filters for the same person by using the Verify API. La modalità matchFace ignora il filtro di appartenenza alla stessa persona.The matchFace mode ignores the same-person filter. Restituisce un elenco di visi candidati simili, che possono o meno appartenere alla stessa persona.It returns a list of similar candidate faces that might or might not belong to the same person.

L'esempio seguente mostra il viso di destinazione:The following example shows the target face:

Una donna sorridente

E questi sono i visi candidati:And these are the candidate faces:

Cinque immagini di persone sorridenti.

Per trovare quattro visi simili, la modalità matchPerson restituisce a e b, che mostrano la stessa persona del viso di destinazione.To find four similar faces, the matchPerson mode returns a and b, which show the same person as the target face. La modalità matchFace restituisce a, b, c, e d, esattamente quattro candidati, anche se alcuni non appartengono alla stessa persona della destinazione o la somiglianza è minore.The matchFace mode returns a, b, c, and d, exactly four candidates, even if some aren't the same person as the target or have low similarity. Per altre informazioni, vedere l'articolo che illustra i concetti relativi al riconoscimento del viso o consultare la documentazione di riferimento dell'API di individuazione di visi simili.For more information, see the Face recognition concepts guide or the Find Similar API reference documentation.

Raggruppamento dei visiFace grouping

L'API di raggruppamento divide un set di visi sconosciuti in più gruppi basati sulla somiglianza.The Group API divides a set of unknown faces into several groups based on similarity. Ogni gruppo è un subset proprio indipendente del set di visi originale.Each group is a disjoint proper subset of the original set of faces. Tutti i visi nello stesso gruppo appartengono probabilmente alla stessa persona.All of the faces in a group are likely to belong to the same person. Possono essere presenti gruppi diversi per una singola persona,There can be several different groups for a single person. che si differenziano per un altro fattore, ad esempio l'espressione.The groups are differentiated by another factor, such as expression, for example. Per altre informazioni, vedere l'articolo che illustra i concetti relativi al riconoscimento del viso o consultare la documentazione di riferimento dell'API di raggruppamento.For more information, see the Face recognition concepts guide or the Group API reference documentation.

Identificazione delle personePerson identification

L'API di identificazione viene usata per identificare un viso rilevato confrontandolo con un database di persone.The Identify API is used to identify a detected face against a database of people. Questa funzionalità può essere utile per l'aggiunta automatica di tag alle immagini nel software di gestione delle foto.This feature might be useful for automatic image tagging in photo management software. È possibile creare questo database in anticipo e modificarlo nel tempo.You create the database in advance, and you can edit it over time.

L'immagine seguente mostra un esempio di un database denominato "myfriends".The following image shows an example of a database named "myfriends". Ogni gruppo può contenere fino a 1 milione di oggetti persona diversi.Each group can contain up to 1 million different person objects. Per ogni oggetto persona è possibile registrare fino a 248 visi.Each person object can have up to 248 faces registered.

Griglia con tre colonne per persone diverse, ognuna con tre righe di immagini dei visi

Dopo la creazione e il training di un database, è possibile eseguire l'identificazione in base al gruppo con un nuovo viso rilevato.After you create and train a database, you can perform identification against the group with a new detected face. Se il viso viene identificato come una persona nel gruppo, viene restituito l'oggetto persona.If the face is identified as a person in the group, the person object is returned.

Per altre informazioni sull'identificazione delle persone, vedere l'articolo che illustra i concetti relativi al riconoscimento del viso o consultare la documentazione di riferimento dell'API di identificazione.For more information about person identification, see the Face recognition concepts guide or the Identify API reference documentation.

Usare i contenitoriUse containers

Usare il contenitore Viso per rilevare, riconoscere e identificare visi installando un contenitore Docker standardizzato più vicino ai dati.Use the Face container to detect, recognize, and identify faces by installing a standardized Docker container closer to your data.

App di esempioSample apps

Le applicazioni di esempio seguenti illustrano alcuni dei modi in cui si può usare l'API Viso:The following sample applications show a few ways to use the Face API:

Sicurezza e privacy dei datiData privacy and security

Come per tutte le risorse di Servizi cognitivi, gli sviluppatori che usano il servizio Viso devono conoscere i criteri di Microsoft sui dati dei clienti.As with all of the Cognitive Services resources, developers who use the Face service must be aware of Microsoft's policies on customer data. Per altre informazioni, vedere la pagina su Servizi cognitivi nel Centro protezione di Microsoft.For more information, see the Cognitive Services page on the Microsoft Trust Center.

Passaggi successiviNext steps

Seguire un argomento di avvio rapido per implementare un semplice scenario di rilevamento del viso nel codice:Follow a quickstart to implement a face-detection scenario in code: