Partilhar via


Face Detection Operations - Detect

Detete rostos humanos em uma imagem, retorne retângulos faciais e, opcionalmente, com faceIds, pontos de referência e atributos.

Importante

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 azureface@microsoft.com 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 https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

    • Nenhuma imagem será armazenada. Apenas o(s) recurso(s) de face extraído(s) será(ão) armazenado(s) no servidor. O faceId é um identificador do recurso de rosto e será usado em "Identificar", "Verificar" e "Encontrar semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado pelo faceIdTimeToLive após a chamada de deteção original.
    • Os parâmetros opcionais incluem faceId, pontos de referência e atributos. Os atributos incluem headPose, óculos, oclusão, acessórios, desfoque, exposição, ruído, máscara e qualidadeForRecognition. Alguns dos resultados retornados para atributos específicos podem não ser altamente precisos.
    • JPEG, PNG, GIF (o primeiro quadro) e BMP são suportados. O tamanho permitido do arquivo de imagem é de 1KB a 6MB.
    • O tamanho mínimo detetável da face é de 36x36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920x1080 pixels precisarão de um tamanho mínimo de rosto proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande para pequeno.
    • Para obter os melhores resultados ao consultar "Identificar", "Verificar" e "Localizar semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200x200 pixels (100 pixels entre os olhos).
    • Diferentes valores de 'detectionModel' podem ser fornecidos. Para usar e comparar diferentes modelos de deteção, consulte https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
      • 'detection_02': Os atributos e pontos de referência do rosto são desativados se você escolher este modelo de deteção.
      • 'detection_03': Atributos faciais (máscara, desfoque e headPose) e pontos de referência são suportados se você escolher este modelo de deteção.
    • Diferentes valores de 'recognitionModel' são fornecidos. Se forem necessárias operações de acompanhamento como "Verify", "Identify", "Find Similar", especifique o modelo de reconhecimento com o parâmetro 'recognitionModel'. O valor padrão para 'recognitionModel' é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo que você precisa neste parâmetro. Uma vez especificados, os faceIds detetados serão associados ao modelo de reconhecimento especificado. Mais detalhes, consulte https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.
POST {endpoint}/face/{apiVersion}/detect
POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parâmetros do URI

Name Em Necessário Tipo Description
apiVersion
path True

string

Versão da API

endpoint
path True

string

uri

Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://{resource-name}.cognitiveservices.azure.com).

detectionModel
query

DetectionModel

O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.

faceIdTimeToLive
query

integer

int32

O número de segundos para o face ID que está sendo armazenado em cache. Intervalo suportado de 60 segundos até 86400 segundos. O valor padrão é 86400 (24 horas).

recognitionModel
query

RecognitionModel

O 'recognitionModel' associado aos faceIds detetados. Os valores 'recognitionModel' suportados incluem 'recognition_01', 'recognition_02', 'recognition_03' ou 'recognition_04'. O valor padrão é 'recognition_01'. 'recognition_04' é recomendado, uma vez que a sua precisão é melhorada em rostos que usam máscaras em comparação com 'recognition_03', e a sua precisão geral é melhorada em comparação com 'recognition_01' e 'recognition_02'.

returnFaceAttributes
query

FaceAttributeType[]

Analise e retorne um ou mais atributos de face especificados na cadeia de caracteres separada por vírgulas, como 'returnFaceAttributes=headPose,glasses'. A análise de atributos faciais tem custo computacional e de tempo adicional.

returnFaceId
query

boolean

Retornar faceIds dos rostos detetados ou não. O valor padrão é true.

returnFaceLandmarks
query

boolean

Retorne pontos de referência faciais dos rostos detetados ou não. O valor padrão é false.

returnRecognitionModel
query

boolean

Retornar 'recognitionModel' ou não. O valor padrão é false. Isso só é aplicável quando returnFaceId = true.

Corpo do Pedido

Media Types: "application/octet-stream"

Name Tipo Description
imageContent

string

O binário da imagem de entrada.

Respostas

Name Tipo Description
200 OK

FaceDetectionResult[]

Uma chamada bem-sucedida retorna uma matriz de entradas de rosto classificadas pelo tamanho do retângulo facial em ordem decrescente. Uma resposta vazia indica que nenhum rosto foi detetado.

Other Status Codes

FaceErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta para sua assinatura do Azure AI Face.

Tipo: apiKey
Em: header

AADToken

O fluxo OAuth2 do Azure Ative Directory

Tipo: oauth2
Fluxo: accessCode
URL de Autorização: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Âmbitos

Name Description
https://cognitiveservices.azure.com/.default

Exemplos

Detect with Image

Pedido de amostra

POST {endpoint}/face/v1.2-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Resposta da amostra

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Definições

Name Description
AccessoryItem

Item acessório e correspondente nível de confiança.

AccessoryType

Tipo de acessório.

BlurLevel

Indica o nível de desfocagem.

BlurProperties

Propriedades que descrevem qualquer presença de desfoque na imagem.

DetectionModel

O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.

ExposureLevel

Indica o nível de exposição.

ExposureProperties

Propriedades que descrevem o nível de exposição da imagem.

FaceAttributes

Atributos de rosto para o rosto detetado.

FaceAttributeType

Analise e retorne um ou mais atributos de face especificados na cadeia de caracteres separada por vírgulas, como 'returnFaceAttributes=headPose,glasses'. A análise de atributos faciais tem custo computacional e de tempo adicional.

FaceDetectionResult

Resposta para detetar API.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

FaceLandmarks

Uma coleção de pontos de referência de rosto de 27 pontos que apontam para as posições importantes dos componentes do rosto.

FaceRectangle

Um retângulo dentro do qual um rosto pode ser encontrado.

FacialHair

Propriedades que descrevem os atributos dos pelos faciais.

GlassesType

Tipo de óculos do rosto.

HairColor

Uma variedade de cores candidatas e nível de confiança na presença de cada um.

HairColorType

Nome da cor do cabelo.

HairProperties

Propriedades que descrevem os atributos do cabelo.

HeadPose

Ângulos de rolo/bocejo/passo 3D para a direção da face.

LandmarkCoordinate

Coordenadas de ponto de referência dentro de uma imagem.

MaskProperties

Propriedades que descrevem a presença de uma máscara em um determinado rosto.

MaskType

Tipo de máscara.

NoiseLevel

Indica o nível de ruído.

NoiseProperties

Propriedades que descrevem o nível de ruído da imagem.

OcclusionProperties

Propriedades que descrevem oclusões em uma determinada face.

QualityForRecognition

Indica a qualidade da imagem para reconhecimento.

RecognitionModel

O modelo de reconhecimento para o rosto.

AccessoryItem

Item acessório e correspondente nível de confiança.

Name Tipo Description
confidence

number

Nível de confiança do tipo de acessório. Intervalo entre [0,1].

type

AccessoryType

Tipo de acessório.

AccessoryType

Tipo de acessório.

Name Tipo Description
glasses

string

Óculos.

headwear

string

Desgaste da cabeça.

mask

string

Máscara.

BlurLevel

Indica o nível de desfocagem.

Name Tipo Description
high

string

Alto nível de desfoque.

low

string

Baixo nível de desfoque.

medium

string

Nível médio de desfoque.

BlurProperties

Propriedades que descrevem qualquer presença de desfoque na imagem.

Name Tipo Description
blurLevel

BlurLevel

Um valor de enum que indica o nível de desfocagem.

value

number

Um número que indica o nível de desfocagem que varia de 0 a 1.

DetectionModel

O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.

Name Tipo Description
detection_01

string

O modelo de deteção padrão. Recomendado para deteção de face frontal próxima. Para cenários com faces de ângulo excepcionalmente grande (head-pose), rostos ocluídos ou orientação de imagem errada, os rostos nesses casos podem não ser detetados.

detection_02

string

Modelo de deteção lançado em maio de 2019 com maior precisão, especialmente em rostos pequenos, laterais e desfocados.

detection_03

string

Modelo de deteção lançado em fevereiro de 2021 com precisão melhorada, especialmente em rostos pequenos.

ExposureLevel

Indica o nível de exposição.

Name Tipo Description
goodExposure

string

Bom nível de exposição.

overExposure

string

Nível de exposição elevado.

underExposure

string

Baixo nível de exposição.

ExposureProperties

Propriedades que descrevem o nível de exposição da imagem.

Name Tipo Description
exposureLevel

ExposureLevel

Um valor enum que indica o nível de exposição.

value

number

Um número que indica o nível de exposição que varia entre 0 e 1. [0, 0,25) está sob exposição. [0,25; 0,75) é uma boa exposição. [0,75, 1] é excesso de exposição.

FaceAttributes

Atributos de rosto para o rosto detetado.

Name Tipo Description
accessories

AccessoryItem[]

Propriedades que descrevem quaisquer acessórios em um determinado rosto.

age

number

Idade em anos.

blur

BlurProperties

Propriedades que descrevem qualquer presença de desfoque na imagem.

exposure

ExposureProperties

Propriedades que descrevem o nível de exposição da imagem.

facialHair

FacialHair

Propriedades que descrevem os atributos dos pelos faciais.

glasses

GlassesType

Tipo de óculos, se algum do rosto.

hair

HairProperties

Propriedades que descrevem os atributos do cabelo.

headPose

HeadPose

Ângulos de rolo/bocejo/passo 3D para a direção da face.

mask

MaskProperties

Propriedades que descrevem a presença de uma máscara em um determinado rosto.

noise

NoiseProperties

Propriedades que descrevem o nível de ruído da imagem.

occlusion

OcclusionProperties

Propriedades que descrevem oclusões em uma determinada face.

qualityForRecognition

QualityForRecognition

Propriedades que descrevem a qualidade geral da imagem em relação a se a imagem que está sendo usada na deteção é de qualidade suficiente para tentar o reconhecimento facial.

smile

number

Intensidade do sorriso, um número entre [0,1].

FaceAttributeType

Analise e retorne um ou mais atributos de face especificados na cadeia de caracteres separada por vírgulas, como 'returnFaceAttributes=headPose,glasses'. A análise de atributos faciais tem custo computacional e de tempo adicional.

Name Tipo Description
accessories

string

Acessórios à volta do rosto, incluindo 'headwear', 'óculos' e 'máscara'. Matriz vazia significa que nenhum acessório foi detetado. Observe que isso ocorre depois que um rosto é detetado. Máscara grande pode resultar em nenhum rosto a ser detetado.

age

string

Idade em anos.

blur

string

O rosto está embaçado ou não. Nível retorna 'Baixo', 'Médio' ou 'Alto'. O valor devolve um número entre [0,1], quanto maior for o desfoque.

exposure

string

Nível de exposição facial. O nível retorna 'GoodExposure', 'OverExposure' ou 'UnderExposure'.

facialHair

string

Propriedades que descrevem os atributos dos pelos faciais.

glasses

string

Tipo de óculos. Os valores incluem 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles'.

hair

string

Propriedades que descrevem os atributos do cabelo.

headPose

string

Ângulos de rolo/bocejo/passo 3D para a direção da face.

mask

string

Se cada rosto está usando uma máscara. O tipo de máscara retorna 'noMask', 'faceMask', 'otherMaskOrOcclusion' ou 'uncertain'. O valor retorna um booleano 'noseAndMouthCovered' indicando se o nariz e a boca estão cobertos.

noise

string

Nível de ruído dos pixels do rosto. Nível retorna 'Baixo', 'Médio' e 'Alto'. O valor devolve um número entre [0,1], quanto maior for o ruído

occlusion

string

Se cada área facial está ocluída, incluindo testa, olhos e boca.

qualityForRecognition

string

A qualidade geral da imagem em relação a se a imagem que está sendo usada na deteção é de qualidade suficiente para tentar o reconhecimento facial. O valor é uma classificação informal de baixo, médio ou alto. Apenas imagens de "alta" qualidade são recomendadas para inscrição de pessoas e qualidade igual ou superior a "média" é recomendada para cenários de identificação. O atributo só está disponível ao usar modelos de reconhecimento recognition_03 ou recognition_04.

smile

string

Intensidade do sorriso, um número entre [0,1].

FaceDetectionResult

Resposta para detetar API.

Name Tipo Description
faceAttributes

FaceAttributes

Atributos de rosto para rosto detetado.

faceId

string

FaceId exclusivo do rosto detetado, criado pela API de deteção e expirará 24 horas após a chamada de deteção. Para retornar isso, ele requer que o parâmetro 'returnFaceId' seja verdadeiro.

faceLandmarks

FaceLandmarks

Uma matriz de pontos de referência de face de 27 pontos apontando para as posições importantes dos componentes da face. Para retornar isso, ele requer que o parâmetro 'returnFaceLandmarks' seja true.

faceRectangle

FaceRectangle

Uma área de retângulo para a localização do rosto na imagem.

recognitionModel

RecognitionModel

O 'recognitionModel' associado a este faceId. Isso só é retornado quando 'returnRecognitionModel' é explicitamente definido como true.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

Name Tipo Description
code

string

Um de um conjunto de códigos de erro definido pelo servidor.

message

string

Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

Name Tipo Description
error

FaceError

O objeto de erro.

FaceLandmarks

Uma coleção de pontos de referência de rosto de 27 pontos que apontam para as posições importantes dos componentes do rosto.

Name Tipo Description
eyeLeftBottom

LandmarkCoordinate

As coordenadas do fundo do olho esquerdo.

eyeLeftInner

LandmarkCoordinate

As coordenadas do olho esquerdo interno.

eyeLeftOuter

LandmarkCoordinate

As coordenadas do olho esquerdo para fora.

eyeLeftTop

LandmarkCoordinate

As coordenadas do topo do olho esquerdo.

eyeRightBottom

LandmarkCoordinate

As coordenadas do fundo do olho direito.

eyeRightInner

LandmarkCoordinate

As coordenadas do olho direito interno.

eyeRightOuter

LandmarkCoordinate

As coordenadas do olho direito para fora.

eyeRightTop

LandmarkCoordinate

As coordenadas do topo do olho direito.

eyebrowLeftInner

LandmarkCoordinate

As coordenadas do interior da sobrancelha esquerda.

eyebrowLeftOuter

LandmarkCoordinate

As coordenadas da sobrancelha esquerda externa.

eyebrowRightInner

LandmarkCoordinate

As coordenadas do interior da sobrancelha direita.

eyebrowRightOuter

LandmarkCoordinate

As coordenadas do exterior da sobrancelha direita.

mouthLeft

LandmarkCoordinate

As coordenadas da boca esquerda.

mouthRight

LandmarkCoordinate

As coordenadas da boca direita.

noseLeftAlarOutTip

LandmarkCoordinate

As coordenadas do nariz deixaram alar ponta para fora.

noseLeftAlarTop

LandmarkCoordinate

As coordenadas do nariz esquerda alar topo.

noseRightAlarOutTip

LandmarkCoordinate

As coordenadas do nariz à direita alar ponta para fora.

noseRightAlarTop

LandmarkCoordinate

As coordenadas do nariz alar superior direito.

noseRootLeft

LandmarkCoordinate

As coordenadas da raiz do nariz à esquerda.

noseRootRight

LandmarkCoordinate

As coordenadas da raiz do nariz à direita.

noseTip

LandmarkCoordinate

As coordenadas da ponta do nariz.

pupilLeft

LandmarkCoordinate

As coordenadas da pupila do olho esquerdo.

pupilRight

LandmarkCoordinate

As coordenadas da pupila do olho direito.

underLipBottom

LandmarkCoordinate

As coordenadas do fundo do lábio inferior.

underLipTop

LandmarkCoordinate

As coordenadas do topo do lábio inferior.

upperLipBottom

LandmarkCoordinate

As coordenadas do lábio superior inferior.

upperLipTop

LandmarkCoordinate

As coordenadas do topo do lábio superior.

FaceRectangle

Um retângulo dentro do qual um rosto pode ser encontrado.

Name Tipo Description
height

integer

A altura do retângulo, em pixels.

left

integer

A distância da borda esquerda se a imagem para a borda esquerda do retângulo, em pixels.

top

integer

A distância da borda superior se a imagem para a borda superior do retângulo, em pixels.

width

integer

A largura do retângulo, em pixels.

FacialHair

Propriedades que descrevem os atributos dos pelos faciais.

Name Tipo Description
beard

number

Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

moustache

number

Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

sideburns

number

Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

GlassesType

Tipo de óculos do rosto.

Name Tipo Description
noGlasses

string

Sem óculos no rosto.

readingGlasses

string

Óculos normais no rosto.

sunglasses

string

Óculos de sol no rosto.

swimmingGoggles

string

Óculos de natação no rosto.

HairColor

Uma variedade de cores candidatas e nível de confiança na presença de cada um.

Name Tipo Description
color

HairColorType

Nome da cor do cabelo.

confidence

number

Nível de confiança da cor. Intervalo entre [0,1].

HairColorType

Nome da cor do cabelo.

Name Tipo Description
black

string

Preto.

blond

string

Loiro.

brown

string

Castanho.

gray

string

Cinzento.

other

string

Outros.

red

string

Vermelho.

unknown

string

Desconhecido.

white

string

Branco.

HairProperties

Propriedades que descrevem os atributos do cabelo.

Name Tipo Description
bald

number

Um número que descreve o nível de confiança de se a pessoa é careca.

hairColor

HairColor[]

Uma variedade de cores candidatas e nível de confiança na presença de cada um.

invisible

boolean

Um valor booleano que descreve se o cabelo é visível na imagem.

HeadPose

Ângulos de rolo/bocejo/passo 3D para a direção da face.

Name Tipo Description
pitch

number

Valor dos ângulos.

roll

number

Valor dos ângulos.

yaw

number

Valor dos ângulos.

LandmarkCoordinate

Coordenadas de ponto de referência dentro de uma imagem.

Name Tipo Description
x

number

O componente horizontal, em pixels.

y

number

O componente vertical, em pixels.

MaskProperties

Propriedades que descrevem a presença de uma máscara em um determinado rosto.

Name Tipo Description
noseAndMouthCovered

boolean

Um valor booleano que indica se o nariz e a boca estão cobertos.

type

MaskType

Tipo de máscara.

MaskType

Tipo de máscara.

Name Tipo Description
faceMask

string

Máscara facial.

noMask

string

Sem máscara.

otherMaskOrOcclusion

string

Outros tipos de máscara ou oclusão.

uncertain

string

Incerto.

NoiseLevel

Indica o nível de ruído.

Name Tipo Description
high

string

Alto nível de ruído.

low

string

Baixo nível de ruído.

medium

string

Nível de ruído médio.

NoiseProperties

Propriedades que descrevem o nível de ruído da imagem.

Name Tipo Description
noiseLevel

NoiseLevel

Um valor de enum que indica o nível de ruído.

value

number

Um número que indica o nível de ruído que varia de 0 a 1. [0, 0,25) está sob exposição. [0,25; 0,75) é uma boa exposição. [0,75, 1] é excesso de exposição. [0, 0,3) é um baixo nível de ruído. [0,3, 0,7) é um nível de ruído médio. [0,7, 1] é um nível de ruído elevado.

OcclusionProperties

Propriedades que descrevem oclusões em uma determinada face.

Name Tipo Description
eyeOccluded

boolean

Um valor booleano que indica se os olhos estão ocluídos.

foreheadOccluded

boolean

Um valor booleano que indica se a testa está ocluída.

mouthOccluded

boolean

Um valor booleano que indica se a boca está ocluída.

QualityForRecognition

Indica a qualidade da imagem para reconhecimento.

Name Tipo Description
high

string

Alta qualidade.

low

string

Baixa qualidade.

medium

string

Qualidade média.

RecognitionModel

O modelo de reconhecimento para o rosto.

Name Tipo Description
recognition_01

string

O modelo de reconhecimento padrão para "Detetar". Todos os faceIds criados antes de março de 2019 estão ligados a este modelo de reconhecimento.

recognition_02

string

Modelo de reconhecimento lançado em março de 2019.

recognition_03

string

Modelo de reconhecimento lançado em maio de 2020.

recognition_04

string

Modelo de reconhecimento lançado em fevereiro de 2021. Recomenda-se usar este modelo de reconhecimento para uma melhor precisão de reconhecimento.