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 da IA do Azure 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.

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.

Face de mulher no teto com análise da pesquisa visual

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

Detecção facial de foto de família com análise da pesquisa visual

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