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 |
---|---|---|---|---|
api
|
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). |
detection
|
query |
O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'. |
||
face
|
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). |
|
recognition
|
query |
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'. |
||
return
|
query |
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. |
||
return
|
query |
boolean |
Retornar faceIds dos rostos detetados ou não. O valor padrão é true. |
|
return
|
query |
boolean |
Retorne pontos de referência faciais dos rostos detetados ou não. O valor padrão é false. |
|
return
|
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 |
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 |
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 |
---|---|
Accessory |
Item acessório e correspondente nível de confiança. |
Accessory |
Tipo de acessório. |
Blur |
Indica o nível de desfocagem. |
Blur |
Propriedades que descrevem qualquer presença de desfoque na imagem. |
Detection |
O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'. |
Exposure |
Indica o nível de exposição. |
Exposure |
Propriedades que descrevem o nível de exposição da imagem. |
Face |
Atributos de rosto para o rosto detetado. |
Face |
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. |
Face |
Resposta para detetar API. |
Face |
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. |
Face |
Uma resposta contendo detalhes do erro. |
Face |
Uma coleção de pontos de referência de rosto de 27 pontos que apontam para as posições importantes dos componentes do rosto. |
Face |
Um retângulo dentro do qual um rosto pode ser encontrado. |
Facial |
Propriedades que descrevem os atributos dos pelos faciais. |
Glasses |
Tipo de óculos do rosto. |
Hair |
Uma variedade de cores candidatas e nível de confiança na presença de cada um. |
Hair |
Nome da cor do cabelo. |
Hair |
Propriedades que descrevem os atributos do cabelo. |
Head |
Ângulos de rolo/bocejo/passo 3D para a direção da face. |
Landmark |
Coordenadas de ponto de referência dentro de uma imagem. |
Mask |
Propriedades que descrevem a presença de uma máscara em um determinado rosto. |
Mask |
Tipo de máscara. |
Noise |
Indica o nível de ruído. |
Noise |
Propriedades que descrevem o nível de ruído da imagem. |
Occlusion |
Propriedades que descrevem oclusões em uma determinada face. |
Quality |
Indica a qualidade da imagem para reconhecimento. |
Recognition |
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 |
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 |
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 |
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 |
Propriedades que descrevem quaisquer acessórios em um determinado rosto. |
|
age |
number |
Idade em anos. |
blur |
Propriedades que descrevem qualquer presença de desfoque na imagem. |
|
exposure |
Propriedades que descrevem o nível de exposição da imagem. |
|
facialHair |
Propriedades que descrevem os atributos dos pelos faciais. |
|
glasses |
Tipo de óculos, se algum do rosto. |
|
hair |
Propriedades que descrevem os atributos do cabelo. |
|
headPose |
Ângulos de rolo/bocejo/passo 3D para a direção da face. |
|
mask |
Propriedades que descrevem a presença de uma máscara em um determinado rosto. |
|
noise |
Propriedades que descrevem o nível de ruído da imagem. |
|
occlusion |
Propriedades que descrevem oclusões em uma determinada face. |
|
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 |
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 |
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 |
Uma área de retângulo para a localização do rosto na imagem. |
|
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 |
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 |
As coordenadas do fundo do olho esquerdo. |
|
eyeLeftInner |
As coordenadas do olho esquerdo interno. |
|
eyeLeftOuter |
As coordenadas do olho esquerdo para fora. |
|
eyeLeftTop |
As coordenadas do topo do olho esquerdo. |
|
eyeRightBottom |
As coordenadas do fundo do olho direito. |
|
eyeRightInner |
As coordenadas do olho direito interno. |
|
eyeRightOuter |
As coordenadas do olho direito para fora. |
|
eyeRightTop |
As coordenadas do topo do olho direito. |
|
eyebrowLeftInner |
As coordenadas do interior da sobrancelha esquerda. |
|
eyebrowLeftOuter |
As coordenadas da sobrancelha esquerda externa. |
|
eyebrowRightInner |
As coordenadas do interior da sobrancelha direita. |
|
eyebrowRightOuter |
As coordenadas do exterior da sobrancelha direita. |
|
mouthLeft |
As coordenadas da boca esquerda. |
|
mouthRight |
As coordenadas da boca direita. |
|
noseLeftAlarOutTip |
As coordenadas do nariz deixaram alar ponta para fora. |
|
noseLeftAlarTop |
As coordenadas do nariz esquerda alar topo. |
|
noseRightAlarOutTip |
As coordenadas do nariz à direita alar ponta para fora. |
|
noseRightAlarTop |
As coordenadas do nariz alar superior direito. |
|
noseRootLeft |
As coordenadas da raiz do nariz à esquerda. |
|
noseRootRight |
As coordenadas da raiz do nariz à direita. |
|
noseTip |
As coordenadas da ponta do nariz. |
|
pupilLeft |
As coordenadas da pupila do olho esquerdo. |
|
pupilRight |
As coordenadas da pupila do olho direito. |
|
underLipBottom |
As coordenadas do fundo do lábio inferior. |
|
underLipTop |
As coordenadas do topo do lábio inferior. |
|
upperLipBottom |
As coordenadas do lábio superior inferior. |
|
upperLipTop |
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 |
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 |
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 |
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 |
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. |