Face Detection Operations - Detect

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://learn.microsoft.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://learn.microsoft.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=detect&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

Media Types: "application/octet-stream"

Nome	Tipo	Description
imageContent	string	O binário de imagem de entrada.

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

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 with Image

Solicitação de exemplo

HTTP

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

Compartilhar via

Face Detection Operations - Detect

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

AADToken

Escopos

Exemplos

Detect with Image

Solicitação de exemplo

Resposta de exemplo

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

Recursos adicionais