Face Detection Operations - Detect

Serviço:: Azure AI Services

Versão da API:: v1.2

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. E-mail API do Azure Face 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 aqui.

- 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. A disponibilidade de pontos de referência e atributos suportados depende do modelo de deteção especificado. Para usar e comparar diferentes modelos de deteção, consulte aqui.
- 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 aqui.

POST {endpoint}/face/{apiVersion}/detect

Com parâmetros opcionais:

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'. 'detection_03' é recomendado, uma vez que a sua precisão é melhorada em faces mais pequenas (64x64 pixels) e orientações faciais rotativas.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	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 (binary)	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

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

HTTP

POST {endpoint}/face/v1.2/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

Código de estado:: 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

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'. 'detection_03' é recomendado, uma vez que a sua precisão é melhorada em faces mais pequenas (64x64 pixels) e orientações faciais rotativas.
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

Object

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

Name	Tipo	Description
confidence	number (float) minimum: 0 maximum: 1	Nível de confiança do tipo de acessório. Intervalo entre [0,1].
type	AccessoryType	Tipo de acessório.

AccessoryType

Enumeração

Tipo de acessório.

Valor	Description
headwear	Desgaste da cabeça.
glasses	Óculos.
mask	Máscara.

BlurLevel

Enumeração

Indica o nível de desfocagem.

Valor	Description
low	Baixo nível de desfoque.
medium	Nível médio de desfoque.
high	Alto nível de desfoque.

BlurProperties

Object

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 (float) minimum: 0 maximum: 1	Um número que indica o nível de desfocagem que varia de 0 a 1.

DetectionModel

Enumeração

O 'detectionModel' associado aos faceIds detetados. Os valores 'detectionModel' suportados incluem 'detection_01', 'detection_02' e 'detection_03'. O valor padrão é 'detection_01'. 'detection_03' é recomendado, uma vez que a sua precisão é melhorada em faces mais pequenas (64x64 pixels) e orientações faciais rotativas.

Valor	Description
detection_01	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	Modelo de deteção lançado em maio de 2019 com maior precisão, especialmente em rostos pequenos, laterais e desfocados.
detection_03	Modelo de deteção lançado em fevereiro de 2021 com precisão melhorada, especialmente em rostos pequenos.

ExposureLevel

Enumeração

Indica o nível de exposição.

Valor	Description
underExposure	Baixo nível de exposição.
goodExposure	Bom nível de exposição.
overExposure	Nível de exposição elevado.

ExposureProperties

Object

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 (float) minimum: 0 maximum: 1	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

Object

Atributos de rosto para o rosto detetado.

Name	Tipo	Description
accessories	AccessoryItem[]	Propriedades que descrevem quaisquer acessórios em um determinado rosto.
age	number (float)	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 (float) minimum: 0 maximum: 1	Intensidade do sorriso, um número entre [0,1].

FaceAttributeType

Enumeração

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.

Valor	Description
headPose	Ângulos de rolo/bocejo/passo 3D para a direção da face.
glasses	Tipo de óculos. Os valores incluem 'NoGlasses', 'ReadingGlasses', 'Sunglasses', 'SwimmingGoggles'.
occlusion	Se cada área facial está ocluída, incluindo testa, olhos e boca.
accessories	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.
blur	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	Nível de exposição facial. O nível retorna 'GoodExposure', 'OverExposure' ou 'UnderExposure'.
noise	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
mask	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.
qualityForRecognition	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.
age	Idade em anos.
smile	Intensidade do sorriso, um número entre [0,1].
facialHair	Propriedades que descrevem os atributos dos pelos faciais.
hair	Propriedades que descrevem os atributos do cabelo.

FaceDetectionResult

Object

Resposta para detetar API.

Name	Tipo	Description
faceAttributes	FaceAttributes	Atributos de rosto para rosto detetado.
faceId	string (uuid)	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

Object

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

Object

Uma resposta contendo detalhes do erro.

Name	Tipo	Description
error	FaceError	O objeto de erro.

FaceLandmarks

Object

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

Object

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

Name	Tipo	Description
height	integer (int32)	A altura do retângulo, em pixels.
left	integer (int32)	A distância da borda esquerda se a imagem para a borda esquerda do retângulo, em pixels.
top	integer (int32)	A distância da borda superior se a imagem para a borda superior do retângulo, em pixels.
width	integer (int32)	A largura do retângulo, em pixels.

FacialHair

Object

Propriedades que descrevem os atributos dos pelos faciais.

Name	Tipo	Description
beard	number (float) minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
moustache	number (float) minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
sideburns	number (float) minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

GlassesType

Enumeração

Tipo de óculos do rosto.

Valor	Description
noGlasses	Sem óculos no rosto.
readingGlasses	Óculos normais no rosto.
sunglasses	Óculos de sol no rosto.
swimmingGoggles	Óculos de natação no rosto.

HairColor

Object

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 (float) minimum: 0 maximum: 1	Nível de confiança da cor. Intervalo entre [0,1].

HairColorType

Enumeração

Nome da cor do cabelo.

Valor	Description
unknown	Desconhecido.
white	Branco.
gray	Cinzento.
blond	Loiro.
brown	Castanho.
red	Vermelho.
black	Preto.
other	Outros.

HairProperties

Object

Propriedades que descrevem os atributos do cabelo.

Name	Tipo	Description
bald	number (float) minimum: 0 maximum: 1	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

Object

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

Name	Tipo	Description
pitch	number (float)	Valor dos ângulos.
roll	number (float)	Valor dos ângulos.
yaw	number (float)	Valor dos ângulos.

LandmarkCoordinate

Object

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

Name	Tipo	Description
x	number (float)	O componente horizontal, em pixels.
y	number (float)	O componente vertical, em pixels.

MaskProperties

Object

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

Enumeração

Tipo de máscara.

Valor	Description
faceMask	Máscara facial.
noMask	Sem máscara.
otherMaskOrOcclusion	Outros tipos de máscara ou oclusão.
uncertain	Incerto.

NoiseLevel

Enumeração

Indica o nível de ruído.

Valor	Description
low	Baixo nível de ruído.
medium	Nível de ruído médio.
high	Alto nível de ruído.

NoiseProperties

Object

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 (float) minimum: 0 maximum: 1	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

Object

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

Enumeração

Indica a qualidade da imagem para reconhecimento.

Valor	Description
low	Baixa qualidade.
medium	Qualidade média.
high	Alta qualidade.

RecognitionModel

Enumeração

O modelo de reconhecimento para o rosto.

Valor	Description
recognition_01	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	Modelo de reconhecimento lançado em março de 2019.
recognition_03	Modelo de reconhecimento lançado em maio de 2020.
recognition_04	Modelo de reconhecimento lançado em fevereiro de 2021. Recomenda-se usar este modelo de reconhecimento para uma melhor precisão de reconhecimento.

Partilhar via

Face Detection Operations - Detect

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

Ocp-Apim-Subscription-Key

AADToken

Âmbitos

Exemplos

Detect with Image

Pedido de amostra

Resposta da amostra

Definições

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel