Deteção de rosto com Análise de Imagem 3.2

O Image Analysis 3.2 pode detetar rostos humanos dentro de uma imagem e gerar coordenadas retangulares para cada face detetada.

Nota

Esse recurso também é oferecido pelo serviço dedicado Azure AI Face . Use essa alternativa para uma análise facial mais detalhada, incluindo identificação facial e deteção de pose de cabeça.

Atenção

A Microsoft aposentou ou limitou os recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se usados indevidamente, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As capacidades aposentadas são a emoção e o género. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquilhagem. Envie um e-mail para a API do Azure Face se você tiver um caso de uso responsável que se beneficiaria do uso de qualquer um dos recursos limitados. Leia mais sobre esta decisão aqui.

Exemplos de deteção de rostos

O exemplo a seguir demonstra a resposta JSON retornada pela API Analyze para uma imagem que contém um único rosto humano.

{
    "faces": [
        {
            "age": 23,
            "gender": "Female",
            "faceRectangle": {
                "top": 45,
                "left": 194,
                "width": 44,
                "height": 44
            }
        }
    ],
    "requestId": "8439ba87-de65-441b-a0f1-c85913157ecd",
    "metadata": {
        "height": 200,
        "width": 300,
        "format": "Png"
    }
}

O próximo exemplo demonstra a resposta JSON retornada para uma imagem que contém várias faces.

{
    "faces": [
        {
            "age": 11,
            "gender": "Male",
            "faceRectangle": {
                "top": 62,
                "left": 22,
                "width": 45,
                "height": 45
            }
        },
        {
            "age": 11,
            "gender": "Female",
            "faceRectangle": {
                "top": 127,
                "left": 240,
                "width": 42,
                "height": 42
            }
        },
        {
            "age": 37,
            "gender": "Female",
            "faceRectangle": {
                "top": 55,
                "left": 200,
                "width": 41,
                "height": 41
            }
        },
        {
            "age": 41,
            "gender": "Male",
            "faceRectangle": {
                "top": 45,
                "left": 103,
                "width": 39,
                "height": 39
            }
        }
    ],
    "requestId": "3a383cbe-1a05-4104-9ce7-1b5cf352b239",
    "metadata": {
        "height": 230,
        "width": 300,
        "format": "Png"
    }
}

Utilizar a API

O recurso de deteção de rosto faz parte da API Analyze Image 3.2 . Você pode chamar essa API por meio de um SDK nativo ou por meio de chamadas REST. Inclua Faces no parâmetro de consulta visualFeatures . Em seguida, quando você obtiver a resposta JSON completa, basta analisar a cadeia de caracteres para o conteúdo da "faces" seção.

• Guia de início rápido: API REST do Vision ou bibliotecas de cliente