Detecção facial com a Análise de Imagem 3.2

A Análise de Imagem 3.2 pode detectar rostos humanos em uma imagem e gerar coordenadas de retângulo para cada rosto detectado.

Observação

Esse recurso também é oferecido pelo serviço de Detecção Facial dedicado. Use essa alternativa para obter uma análise de rosto mais detalhada, incluindo identificação do rosto e detecção de pose da cabeça.

Cuidado

A Microsoft desativará as funcionalidades de reconhecimento facial que podem ser usadas para tentar inferir estados emocionais e atributos de identidade que, se mal utilizados, podem submeter as pessoas a estereótipos, discriminação ou recusa injusta de serviços. Isso inclui recursos que preveem emoção, gênero, idade, sorriso, pelos faciais, cabelo e maquiagem. Leia mais sobre essa decisão aqui.

Experimente os recursos de detecção facial de maneira rápida e fácil no navegador usando o Vision Studio.

Exemplos de detecção facial

O exemplo a seguir demonstra a resposta JSON retornada pela API de Análise de uma imagem contendo um rosto humano.

Vision Analyze Woman Roof Face

{
    "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 de uma imagem contendo vários rostos humanos.

Vision Analyze Family Photo Face

{
    "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"
    }
}

Usar a API

O recurso de detecção facial faz parte da API Análise de Imagem 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 receber a resposta JSON completa, basta analisar a cadeia de caracteres para o conteúdo da seção "faces".