O que é o API Face do Azure?What is the Azure Face API?

Os serviços cognitivas do Azure API de Detecção Facial fornecem algoritmos que são usados para detectar, reconhecer e analisar faces humanas em imagens.The Azure Cognitive Services Face API provides algorithms that are used to detect, recognize, and analyze human faces in images. A capacidade de processar informações de face humana é importante em vários cenários de software diferentes.The ability to process human face information is important in many different software scenarios. Os cenários de exemplo são segurança, interface do usuário natural, análise e gerenciamento de conteúdo de imagem, aplicativos móveis e robótica.Example scenarios are security, natural user interface, image content analysis and management, mobile apps, and robotics.

O API de Detecção Facial fornece várias funções diferentes.The Face API provides several different functions. Cada função é descrita nas seções a seguir.Each function is outlined in the following sections. Continue lendo para saber mais sobre eles.Read on to learn more about them.

Deteção de rostosFace detection

O API de Detecção Facial detecta faces humanas em uma imagem e retorna as coordenadas de retângulo de seus locais.The Face API detects human faces in an image and returns the rectangle coordinates of their locations. Opcionalmente, a detecção facial pode extrair uma série de atributos relacionados à face.Optionally, face detection can extract a series of face-related attributes. Os exemplos são pose de cabeça, gênero, idade, emoções, cabelo facial e óculos.Examples are head pose, gender, age, emotion, facial hair, and glasses.

Nota

O recurso de detecção facial também está disponível por meio do API da pesquisa Visual computacional.The face detection feature is also available through the Computer Vision API. Se você quiser realizar outras operações com dados de face, use o API de Detecção Facial, que é o serviço discutido neste artigo.If you want to do further operations with face data, use the Face API, which is the service discussed in this article.

Uma imagem de uma mulher e um homem, com retângulos desenhados ao redor de suas faces e idade e gênero exibidos

Para obter mais informações sobre a detecção facial, consulte o artigo conceitos de detecção facial .For more information on face detection, see the Face detection concepts article. Consulte também a documentação detectar referência de API .Also see the Detect API reference documentation.

Verificação de rostosFace verification

A Verify API faz a autenticação contra dois rostos detetados ou entre um rosto detetado e um objeto de pessoa.The Verify API performs an authentication against two detected faces or from one detected face to one person object. Na prática, avalia se dois rostos pertencem à mesma pessoa.Practically, it evaluates whether two faces belong to the same person. Esse recurso é potencialmente útil em cenários de segurança.This capability is potentially useful in security scenarios. Para obter mais informações, consulte o guia de conceitos de reconhecimento facial ou a documentação de referência de API de verificação .For more information, see the Face recognition concepts guide or the Verify API reference documentation.

Encontrar rostos semelhantesFind similar faces

A API find similar compara uma face de destino com um conjunto de rostos candidatas para encontrar um conjunto menor de faces que se assemelham à face de destino.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. Há suporte para dois modos de trabalho, matchPerson e matchFace.Two working modes, matchPerson and matchFace, are supported. O modo matchPerson retorna faces semelhantes depois que ele filtra para a mesma pessoa usando a API Verify.The matchPerson mode returns similar faces after it filters for the same person by using the Verify API. O modo matchFace ignora o filtro de mesma pessoa.The matchFace mode ignores the same-person filter. Ele retorna uma lista de faces candidatas semelhantes que podem ou não pertencer à mesma pessoa.It returns a list of similar candidate faces that might or might not belong to the same person.

O exemplo a seguir mostra a face de destino:The following example shows the target face:

Mulher a sorrir

E estes são os rostos candidatos:And these are the candidate faces:

Cinco imagens de pessoas a sorrir.

Para encontrar quatro faces semelhantes, o modo matchPerson retorna a e b, que mostra a mesma pessoa que a face de destino.To find four similar faces, the matchPerson mode returns a and b, which show the same person as the target face. O modo matchFace retorna a, b, c e d, exatamente quatro candidatos, mesmo que alguns não sejam a mesma pessoa que o destino ou tenham pouca semelhança.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. Para obter mais informações, consulte o guia de conceitos de reconhecimento facial ou a documentação de referência de API semelhante .For more information, see the Face recognition concepts guide or the Find Similar API reference documentation.

Agrupamento de rostosFace grouping

A API Agrupamento divide um conjunto de rostos desconhecidos em vários grupos com base na semelhança.The Group API divides a set of unknown faces into several groups based on similarity. Cada grupo é um subconjunto adequado e desassociado do conjunto original de rostos.Each group is a disjoint proper subset of the original set of faces. É provável que todas as faces em um grupo pertençam à mesma pessoa.All of the faces in a group are likely to belong to the same person. Pode haver vários grupos diferentes para uma única pessoa.There can be several different groups for a single person. Os grupos são diferenciados por outro fator, como expressão, por exemplo.The groups are differentiated by another factor, such as expression, for example. Para obter mais informações, consulte o guia conceitos de reconhecimento facial ou a documentação de referência da API de grupo .For more information, see the Face recognition concepts guide or the Group API reference documentation.

Identificação de pessoasPerson identification

A API de identificação é usada para identificar uma face detectada em um banco de dados de pessoas.The Identify API is used to identify a detected face against a database of people. Esse recurso pode ser útil para marcação automática de imagem no software de gerenciamento de fotos.This feature might be useful for automatic image tagging in photo management software. Você cria o banco de dados antecipadamente e pode editá-lo ao longo do tempo.You create the database in advance, and you can edit it over time.

A imagem a seguir mostra um exemplo de um banco de dados chamado "myfriends".The following image shows an example of a database named "myfriends". Cada grupo pode conter até 1 milhão objetos de pessoa diferentes.Each group can contain up to 1 million different person objects. Cada objeto de pessoa pode ter 248 rostos registados.Each person object can have up to 248 faces registered.

Uma grade com três colunas para pessoas diferentes, cada uma com três linhas de imagens de face

Depois de criar e treinar um banco de dados, você pode executar a identificação em relação ao grupo com uma nova face detectada.After you create and train a database, you can perform identification against the group with a new detected face. Se o rosto for identificado como uma pessoa no grupo, esse objeto será devolvido.If the face is identified as a person in the group, the person object is returned.

Para obter mais informações sobre a identificação de pessoa, consulte o guia de conceitos de reconhecimento facial ou a documentação de referência de API de identificação .For more information about person identification, see the Face recognition concepts guide or the Identify API reference documentation.

Utilizar contentoresUse containers

Use o contêiner facial para detectar, reconhecer e identificar faces instalando um contêiner do Docker padronizado mais perto de seus dados.Use the Face container to detect, recognize, and identify faces by installing a standardized Docker container closer to your data.

Exemplos de aplicaçõesSample apps

Os aplicativos de exemplo a seguir mostram algumas maneiras de usar o API de Detecção Facial:The following sample applications show a few ways to use the Face API:

Privacidade e segurança de dadosData privacy and security

Assim como acontece com todos os recursos de serviços cognitivas, os desenvolvedores que usam o serviço de face devem estar cientes das políticas da Microsoft nos dados do cliente.As with all of the Cognitive Services resources, developers who use the Face service must be aware of Microsoft's policies on customer data. Para obter mais informações, consulte a página de serviços cognitivas na central de confiabilidade da Microsoft.For more information, see the Cognitive Services page on the Microsoft Trust Center.

Passos seguintesNext steps

Siga um guia de início rápido para implementar um cenário de detecção facial no código:Follow a quickstart to implement a face-detection scenario in code: