Face Detection Operations - Detect From Session Image Id

  • Referência
Serviço:
Azure AI Services
Versão da API:
v1.2-preview.1

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

Importante

A Microsoft desativa ou limita recursos de reconhecimento facial que podem ser usados para tentar inferir estados emocionais e atributos de identidade que, se mal utilizados, podem sujeitar as pessoas a estereótipos, discriminação ou negação injusta de serviços. As funcionalidades desativadas são emoção e gênero. As capacidades limitadas são idade, sorriso, pelos faciais, cabelo e maquiagem. Envie um email para a API de Detecção Facial do Azure 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 essa decisão https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

    • Nenhuma imagem será armazenada. Somente os recursos de rosto extraídos serão armazenados no servidor. A faceId é um identificador do recurso de detecção facial e será usada em "Identificar", "Verificar" e "Localizar Semelhante". Os recursos de rosto armazenados expirarão e serão excluídos no momento especificado por faceIdTimeToLive após a chamada de detecçã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.
    • Há suporte para JPEG, PNG, GIF (o primeiro quadro) e formato BMP. O tamanho do arquivo de imagem permitido é de 1KB a 6 MB.
    • O tamanho mínimo detectável da face é de 36 x 36 pixels em uma imagem não maior que 1920x1080 pixels. Imagens com dimensões superiores a 1920 x 1080 pixels precisarão de um tamanho de rosto mínimo proporcionalmente maior.
    • Até 100 faces podem ser retornadas para uma imagem. Os rostos são classificados pelo tamanho do retângulo facial de grande a pequeno.
    • Para obter resultados ideais ao consultar "Identificar", "Verificar" e "Localizar Semelhante" ('returnFaceId' é verdadeiro), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200 x 200 pixels (100 pixels entre os olhos).
    • Diferentes valores 'detectionModel' podem ser fornecidos. Para usar e comparar modelos de detecção diferentes, consulte https://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-detection-model
      • 'detection_02': atributos de detecção facial e pontos de referência serão desabilitados se você escolher esse modelo de detecção.
      • 'detection_03': há suporte para atributos de detecção facial (máscara, desfoque e headPose) e pontos de referência se você escolher esse modelo de detecção.
    • Valores 'recognitionModel' diferentes são fornecidos. Se forem necessárias operações de acompanhamento como "Verificar", "Identificar", "Localizar Semelhante", 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 necessário neste parâmetro. Uma vez especificada, as faceIds detectadas serão associadas ao modelo de reconhecimento especificado. Mais detalhes, consulte https://video2.skills-academy.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.
POST {endpoint}/face/{apiVersion}/detect
Com parâmetros opcionais: 
POST {endpoint}/face/{apiVersion}/detect?_overload=detectFromSessionImageId&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
apiVersion
 path True

string

Versão da API
endpoint
 path True

string

uri

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

DetectionModel

O 'detectionModel' associado às faceIds detectadas. Os valores 'detectionModel' com suporte incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.
faceIdTimeToLive
 query

integer

int32

O número de segundos para a ID de rosto sendo armazenada em cache. Intervalo com suporte de 60 segundos até 86400 segundos. O valor padrão é 86400 (24 horas).
recognitionModel
 query

RecognitionModel

O 'recognitionModel' associado às faceIds detectadas. Os valores 'recognitionModel' com suporte incluem 'recognition_01', 'recognition_02', 'recognition_03' ou 'recognition_04'. O valor padrão é 'recognition_01'. 'recognition_04' é recomendado, pois sua precisão é melhorada em rostos usando máscaras em comparação com 'recognition_03', e 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 rosto especificados na cadeia de caracteres separada por vírgulas, como 'returnFaceAttributes=headPose,glasses'. A análise de atributo facial tem custo computacional e de tempo adicionais.
returnFaceId
 query

boolean

Retornar faceIds dos rostos detectados ou não. O valor padrão é true.
returnFaceLandmarks
 query

boolean

Retorne pontos de referência faciais dos rostos detectados 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 da solicitação

Nome Obrigatório Tipo Description
sessionImageId True

string

ID da imagem da sessão.

Respostas

Nome Tipo Description
200 OK

FaceDetectionResult[]

Uma chamada bem-sucedida retorna uma matriz de entradas faciais classificadas pelo tamanho do retângulo facial em ordem decrescente. Uma resposta vazia indica que nenhum rosto foi detectado.
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 Active Directory

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

Escopos

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

Exemplos

Detect From Session Image Id

Solicitação de exemplo

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

{
  "sessionImageId": "aa93ce80-9a9b-48bd-ae1a-1c7543841e92"
}

Resposta de exemplo

Código de status:
200 
[
  {
    "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

Nome Description
AccessoryItem

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

Tipo do acessório.
BlurLevel

Indica o nível de desfoque.
BlurProperties

Propriedades que descrevem qualquer presença de desfoque dentro da imagem.
DetectionModel

O 'detectionModel' associado às faceIds detectadas. Os valores 'detectionModel' com suporte 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 detecção facial para o rosto detectado.
FaceAttributeType

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

Resposta para detectar a API.
FaceError

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

Uma resposta que contém detalhes do erro.
FaceLandmarks

Uma coleção de pontos de referência de rosto de 27 pontos apontando para as posições importantes dos componentes faciais.
FaceRectangle

Um retângulo no qual um rosto pode ser encontrado.
FacialHair

Propriedades que descrevem atributos de pelos faciais.
GlassesType

Tipo de óculos do rosto.
HairColor

Uma matriz de cores de candidato e nível de confiança na presença de cada um.
HairColorType

Nome da cor do cabelo.
HairProperties

Propriedades que descrevem atributos de cabelo.
HeadPose

Ângulos de rolagem/yaw/pitch 3D para a direção do rosto.
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 da 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ãos em um determinado rosto.
QualityForRecognition

Indica a qualidade da imagem para reconhecimento.
RecognitionModel

O modelo de reconhecimento para o rosto.

AccessoryItem

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

Nome Tipo Description
confidence

number

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

AccessoryType

Tipo do acessório.

AccessoryType

Tipo do acessório.

Nome Tipo Description
glasses

string

Óculos.
headwear

string

Uso de cabeça.
mask

string

Máscara.

BlurLevel

Indica o nível de desfoque.

Nome Tipo Description
high

string

Alto nível de desfoque.
low

string

Nível de desfoque baixo.
medium

string

Nível médio de desfoque.

BlurProperties

Propriedades que descrevem qualquer presença de desfoque dentro da imagem.

Nome Tipo Description
blurLevel

BlurLevel

Um valor de enumeração que indica o nível de desfoque.
value

number

Um número que indica o nível de desfoque variando de 0 a 1.

DetectionModel

O 'detectionModel' associado às faceIds detectadas. Os valores 'detectionModel' com suporte incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'.

Nome Tipo Description
detection_01

string

O modelo de detecção padrão. É recomendável para detecção de face frontal próxima. Para cenários com faces de ângulo excepcionalmente grandes (pose de cabeça), rostos ocluídos ou orientação de imagem errada, os rostos nesses casos podem não ser detectados.
detection_02

string

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

string

Modelo de detecção lançado em fevereiro de 2021 com precisão aprimorada especialmente em rostos pequenos.

ExposureLevel

Indica o nível de exposição.

Nome Tipo Description
goodExposure

string

Bom nível de exposição.
overExposure

string

Alto nível de exposição.
underExposure

string

Baixo nível de exposição.

ExposureProperties

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

Nome Tipo Description
exposureLevel

ExposureLevel

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

number

Um número que indica o nível de exposição variando de 0 a 1. [0, 0,25) está sob exposição. [0,25, 0,75) é uma boa exposição. [0,75, 1] é sobre exposição.

FaceAttributes

Atributos de detecção facial para o rosto detectado.

Nome Tipo Description
accessories

AccessoryItem[]

Propriedades que descrevem os acessórios em um determinado rosto.
age

number

Idade em anos.
blur

BlurProperties

Propriedades que descrevem qualquer presença de desfoque dentro da imagem.
exposure

ExposureProperties

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

FacialHair

Propriedades que descrevem atributos de pelos faciais.
glasses

GlassesType

Óculos digitam se qualquer um dos rostos.
hair

HairProperties

Propriedades que descrevem atributos de cabelo.
headPose

HeadPose

Ângulos de rolagem/yaw/pitch 3D para a direção do rosto.
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ãos em um determinado rosto.
qualityForRecognition

QualityForRecognition

Propriedades que descrevem a qualidade geral da imagem sobre se a imagem que está sendo usada na detecçã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 rosto especificados na cadeia de caracteres separada por vírgulas, como 'returnFaceAttributes=headPose,glasses'. A análise de atributo facial tem custo computacional e de tempo adicionais.

Nome Tipo Description
accessories

string

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

string

Idade em anos.
blur

string

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

string

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

string

Propriedades que descrevem atributos de pelos faciais.
glasses

string

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

string

Propriedades que descrevem atributos de cabelo.
headPose

string

Ângulos de rolagem/yaw/pitch 3D para a direção do rosto.
mask

string

Se cada rosto está usando uma máscara. O tipo de máscara retorna 'noMask', 'faceMask', 'otherMaskOrOcclusion' ou 'incerto'. O valor retorna um 'noseAndMouthCovered' booliano que indica se o nariz e a boca estão cobertos.
noise

string

Nível de ruído de pixels de rosto. O nível retorna "Baixo", "Médio" e "Alto". O valor retorna um número entre [0,1], maior o mais barulhento
occlusion

string

Se cada área facial é occluded, incluindo testa, olhos e boca.
qualityForRecognition

string

A qualidade geral da imagem sobre se a imagem que está sendo usada na detecção é de qualidade suficiente para tentar o reconhecimento facial. O valor é uma classificação informal de baixa, média ou alta. Apenas imagens de qualidade 'alta' são recomendadas para registro de pessoas e a qualidade em ou acima '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 detectar a API.

Nome Tipo Description
faceAttributes

FaceAttributes

Atributos de detecção facial para o rosto detectado.
faceId

string

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

FaceLandmarks

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

FaceRectangle

Uma área de retângulo para o local do rosto na imagem.
recognitionModel

RecognitionModel

O 'recognitionModel' associado a essa 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 Serviço de Detecção Facial, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

Nome Tipo Description
code

string

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

string

Uma representação legível pelo ser humano do erro.

FaceErrorResponse

Uma resposta que contém detalhes do erro.

Nome Tipo Description
error

FaceError

O objeto de erro.

FaceLandmarks

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

Nome Tipo Description
eyeLeftBottom

LandmarkCoordinate

As coordenadas da parte inferior esquerda do olho.
eyeLeftInner

LandmarkCoordinate

As coordenadas do olho esquerdo interno.
eyeLeftOuter

LandmarkCoordinate

As coordenadas do olho esquerdo externo.
eyeLeftTop

LandmarkCoordinate

As coordenadas da parte superior esquerda do olho.
eyeRightBottom

LandmarkCoordinate

As coordenadas da parte inferior direita do olho.
eyeRightInner

LandmarkCoordinate

As coordenadas do olho direito interno.
eyeRightOuter

LandmarkCoordinate

As coordenadas do olho direito externo.
eyeRightTop

LandmarkCoordinate

As coordenadas da parte superior direita do olho.
eyebrowLeftInner

LandmarkCoordinate

As coordenadas da sobrancelha esquerda interna.
eyebrowLeftOuter

LandmarkCoordinate

As coordenadas da sobrancelha esquerda externa.
eyebrowRightInner

LandmarkCoordinate

As coordenadas da sobrancelha direita interna.
eyebrowRightOuter

LandmarkCoordinate

As coordenadas da sobrancelha direita externa.
mouthLeft

LandmarkCoordinate

As coordenadas da boca esquerda.
mouthRight

LandmarkCoordinate

As coordenadas da boca direita.
noseLeftAlarOutTip

LandmarkCoordinate

As coordenadas do nariz deixaram a ponta para fora.
noseLeftAlarTop

LandmarkCoordinate

As coordenadas da parte superior esquerda do nariz.
noseRightAlarOutTip

LandmarkCoordinate

As coordenadas do nariz álar para fora da ponta.
noseRightAlarTop

LandmarkCoordinate

As coordenadas da parte superior direita do nariz.
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 da parte inferior do lábio inferior.
underLipTop

LandmarkCoordinate

As coordenadas da parte superior do lábio inferior.
upperLipBottom

LandmarkCoordinate

As coordenadas da parte inferior do lábio superior.
upperLipTop

LandmarkCoordinate

As coordenadas da parte superior do lábio superior.

FaceRectangle

Um retângulo no qual um rosto pode ser encontrado.

Nome Tipo Description
height

integer

A altura do retângulo, em pixels.
left

integer

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

integer

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

integer

A largura do retângulo, em pixels.

FacialHair

Propriedades que descrevem atributos de pelos faciais.

Nome 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.

Nome Tipo Description
noGlasses

string

Sem óculos na cara.
readingGlasses

string

Óculos normais no rosto.
sunglasses

string

Óculos de sol no rosto.
swimmingGoggles

string

Óculos de natação no rosto.

HairColor

Uma matriz de cores de candidato e nível de confiança na presença de cada um.

Nome 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.

Nome Tipo Description
black

string

Preto.
blond

string

Loiro.
brown

string

Marrom.
gray

string

Cinza.
other

string

Outro.
red

string

Vermelho.
unknown

string

Desconhecido.
white

string

Branco.

HairProperties

Propriedades que descrevem atributos de cabelo.

Nome Tipo Description
bald

number

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

HairColor[]

Uma matriz de cores de candidato e nível de confiança na presença de cada um.
invisible

boolean

Um valor booliano que descreve se o cabelo está visível na imagem.

HeadPose

Ângulos de rolagem/yaw/pitch 3D para a direção do rosto.

Nome 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.

Nome 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.

Nome Tipo Description
noseAndMouthCovered

boolean

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

MaskType

Tipo da máscara.

MaskType

Tipo da máscara.

Nome 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.

Nome 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.

Nome Tipo Description
noiseLevel

NoiseLevel

Um valor de enumeração que indica o nível de ruído.
value

number

Um número que indica o nível de ruído variando de 0 a 1. [0, 0,25) está sob exposição. [0,25, 0,75) é uma boa exposição. [0,75, 1] é sobre exposição. [0, 0,3) é baixo nível de ruído. [0.3, 0.7) é o nível de ruído médio. [0,7, 1] é alto nível de ruído.

OcclusionProperties

Propriedades que descrevem oclusãos em um determinado rosto.

Nome Tipo Description
eyeOccluded

boolean

Um valor booliano que indica se os olhos são ocluídos.
foreheadOccluded

boolean

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

boolean

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

QualityForRecognition

Indica a qualidade da imagem para reconhecimento.

Nome Tipo Description
high

string

Alta qualidade.
low

string

Baixa qualidade.
medium

string

Qualidade média.

RecognitionModel

O modelo de reconhecimento para o rosto.

Nome Tipo Description
recognition_01

string

O modelo de reconhecimento padrão para "Detectar". Todas essas faceIds criadas antes de março de 2019 são vinculadas a esse 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. É recomendável usar esse modelo de reconhecimento para melhor precisão de reconhecimento.