Face - Detect With Url

Referência

Serviço:: Azure AI Services

Versão da API:: 1.0-preview

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

Nenhuma imagem será armazenada. Somente o recurso de rosto extraído será armazenado no servidor. A faceId é um identificador do recurso de detecção facial e será usada no Face – Identificar, Face – Verificare Face – LocalizarSemelhante. Os recursos de detecção facial 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 idade, sexo, headPose, sorriso, facialHair, óculos, emoção, cabelo, maquiagem, 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.
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 Face – Identificar, Face – Verificare Face – Localizar Semelhante ('returnFaceId' é true), use rostos que sejam: frontais, claros e com um tamanho mínimo de 200 x 200 pixels (100 pixels entre os olhos).
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.
Diferentes valores 'detectionModel' podem ser fornecidos. Para usar e comparar modelos de detecção diferentes, consulte Como especificar um 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 Especificar um modelo de reconhecimento.

POST {Endpoint}/face/v1.0-preview/detect

Com parâmetros opcionais:

POST {Endpoint}/face/v1.0-preview/detect?returnFaceId={returnFaceId}&returnFaceLandmarks={returnFaceLandmarks}&returnFaceAttributes={returnFaceAttributes}&recognitionModel={recognitionModel}&returnRecognitionModel={returnRecognitionModel}&detectionModel={detectionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
Endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
detectionModel	query		DetectionModel	Nome do modelo de detecção. O modelo de detecção é usado para detectar rostos na imagem enviada. Um nome de modelo de detecção pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Adicionar Face ou (Grande)PersonGroup - Adicionar Face. O valor padrão é 'detection_01', se outro modelo for necessário, especifique-o explicitamente.
faceIdTimeToLive	query		integer minimum: 60 maximum: 86400	O número de segundos para a faceId que está sendo armazenada em cache. Intervalo com suporte de 60 segundos até 86400 segundos. O valor padrão é 86400 (24 horas).
recognitionModel	query		RecognitionModel	Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.
returnFaceAttributes	query		FaceAttributeType[]	Analise e retorne um ou mais atributos de rosto especificados na cadeia de caracteres separada por vírgulas, como "returnFaceAttributes=age,gender". Os atributos disponíveis dependem do 'detectionModel' especificado. 'detection_01' dá suporte à idade, sexo, headPose, sorriso, facialHair, óculos, emoção, cabelo, maquiagem, oclusão, acessórios, desfoque, exposição, ruído e qualidadeForRecognition. Embora o 'detection_02' não dê suporte a nenhum atributo e "detection_03" dê suporte apenas à máscara e à qualidadeForRecognition. Além disso, qualityForRecognition só tem suporte quando o 'recognitionModel' é especificado como 'recognition_03' ou 'recognition_04'. Observe que cada análise de atributo facial tem custo computacional e de tempo adicionais.
returnFaceId	query		boolean	Um valor que indica se a operação deve retornar faceIds de faces detectadas. Detectar com esse valor definido como true requer aprovações de acesso adicionais em https://aka.ms/facerecognition.
returnFaceLandmarks	query		boolean	Um valor que indica se a operação deve retornar pontos de referência dos rostos detectados.
returnRecognitionModel	query		boolean	Um valor que indica se a operação deve retornar 'recognitionModel' em resposta.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
url	True	string	URL acessível publicamente de uma imagem

Respostas

Nome	Tipo	Description
200 OK	DetectedFace[]	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	APIError	Resposta de erro.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Detect with url example

Solicitação de exemplo

HTTP

POST {Endpoint}/face/v1.0-preview/detect?returnFaceAttributes=age,gender,headPose,smile,facialHair,glasses,emotion,hair,makeup,occlusion,accessories,blur,exposure,noise&recognitionModel=recognition_01&returnRecognitionModel=True&detectionModel=detection_01


{
  "url": "{Image Url here}"
}

Resposta de exemplo

Código de status:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_01",
    "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": {
      "age": 71,
      "gender": "male",
      "smile": 0.88,
      "facialHair": {
        "moustache": 0.8,
        "beard": 0.1,
        "sideburns": 0.02
      },
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "emotion": {
        "anger": 0.575,
        "contempt": 0,
        "disgust": 0.006,
        "fear": 0.008,
        "happiness": 0.394,
        "neutral": 0.013,
        "sadness": 0,
        "surprise": 0.004
      },
      "hair": {
        "bald": 0,
        "invisible": false,
        "hairColor": [
          {
            "color": "brown",
            "confidence": 1
          },
          {
            "color": "blond",
            "confidence": 0.88
          },
          {
            "color": "black",
            "confidence": 0.48
          },
          {
            "color": "other",
            "confidence": 0.11
          },
          {
            "color": "gray",
            "confidence": 0.07
          },
          {
            "color": "red",
            "confidence": 0.03
          }
        ]
      },
      "makeup": {
        "eyeMakeup": true,
        "lipMakeup": false
      },
      "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
      }
    }
  }
]

Definições

Nome	Description
Accessory	Item acessório e nível de confiança correspondente.
AccessoryType	Tipo de acessório
APIError	Informações de erro retornadas pela API
Blur	Propriedades que descrevem qualquer presença de desfoque dentro da imagem.
BlurLevel	Um valor de enumeração que indica o nível de desfoque.
Coordinate	Coordenadas dentro de uma imagem
DetectedFace	Objeto Face detectado.
DetectionModel	Modelo de detecção usado ao extrair o rosto.
Emotion	Propriedades que descrevem a emoção facial em forma de confiança variando de 0 a 1.
Error	Corpo do erro.
Exposure	Propriedades que descrevem o nível de exposição da imagem.
ExposureLevel	Um valor de enumeração que indica o nível de exposição.
FaceAttributes	Atributos de detecção facial
FaceAttributeType	Analise e retorne um ou mais atributos de rosto especificados na cadeia de caracteres separada por vírgulas, como "returnFaceAttributes=age,gender". Os atributos disponíveis dependem do 'detectionModel' especificado. 'detection_01' dá suporte à idade, sexo, headPose, sorriso, facialHair, óculos, emoção, cabelo, maquiagem, oclusão, acessórios, desfoque, exposição, ruído e qualidadeForRecognition. Embora o 'detection_02' não dê suporte a nenhum atributo e "detection_03" dê suporte apenas à máscara e à qualidadeForRecognition. Além disso, qualityForRecognition só tem suporte quando o 'recognitionModel' é especificado como 'recognition_03' ou 'recognition_04'. Observe que cada análise de atributo facial tem custo computacional e de tempo adicionais.
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.
Gender	Possível sexo do rosto.
GlassesType	Óculos digitam se qualquer um dos rostos.
Hair	Propriedades que descrevem atributos de cabelo.
HairColor	Cor do cabelo e confiança associada
HairColorType	Nome da cor do cabelo.
HeadPose	Propriedades que indicam a pose da cabeça do rosto.
ImageUrl
Makeup	Propriedades que descrevem a presença de maquiagem em um determinado rosto.
Mask	Propriedades que descrevem a presença de uma máscara em um determinado rosto.
MaskType	Tipo de máscara se qualquer um dos rostos
Noise	Propriedades que descrevem o nível de ruído da imagem.
NoiseLevel	Um valor de enumeração que indica o nível de ruído.
Occlusion	Propriedades que descrevem oclusãos em um determinado rosto.
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.
RecognitionModel	Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

Accessory

Objeto

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

Nome	Tipo	Description
confidence	number minimum: 0 maximum: 1	Nível de confiança de um acessório
type	AccessoryType	Tipo de acessório

AccessoryType

Enumeração

Tipo de acessório

Valor	Description
glasses
headWear
mask

APIError

Objeto

Informações de erro retornadas pela API

Nome	Tipo	Description
error	Error	Corpo do erro.

Blur

Objeto

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 minimum: 0 maximum: 1	Um número que indica o nível de desfoque variando de 0 a 1.

BlurLevel

Enumeração

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

Valor	Description
High
Low
Medium

Coordinate

Objeto

Coordenadas dentro de uma imagem

Nome	Tipo	Description
x	number	O componente horizontal, em pixels.
y	number	O componente vertical, em pixels.

DetectedFace

Objeto

Objeto Face detectado.

Nome	Tipo	Valor padrão	Description
faceAttributes	FaceAttributes		Atributos de detecção facial
faceId	string (uuid)
faceLandmarks	FaceLandmarks		Uma coleção de pontos de referência de rosto de 27 pontos apontando para as posições importantes dos componentes faciais.
faceRectangle	FaceRectangle		Um retângulo no qual um rosto pode ser encontrado
recognitionModel	RecognitionModel	recognition_01	Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

DetectionModel

Enumeração

Modelo de detecção usado ao extrair o rosto.

Valor	Description
detection_01
detection_02
detection_03
detection_preview_1904
expression_01
ir_detection_01

Emotion

Objeto

Propriedades que descrevem a emoção facial em forma de confiança variando de 0 a 1.

Nome	Tipo	Description
anger	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
contempt	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
disgust	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
fear	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
happiness	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
neutral	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
sadness	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.
surprise	number minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

Error

Objeto

Corpo do erro.

Nome	Tipo	Description
code	string
message	string

Exposure

Objeto

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 minimum: 0 maximum: 1	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.

ExposureLevel

Enumeração

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

Valor	Description
GoodExposure
OverExposure
UnderExposure

FaceAttributes

Objeto

Atributos de detecção facial

Nome	Tipo	Description
accessories	Accessory[]	Propriedades que descrevem os acessórios em um determinado rosto.
age	number	Idade em anos
blur	Blur	Propriedades que descrevem qualquer presença de desfoque dentro da imagem.
emotion	Emotion	Propriedades que descrevem a emoção facial em forma de confiança variando de 0 a 1.
exposure	Exposure	Propriedades que descrevem o nível de exposição da imagem.
facialHair	FacialHair	Propriedades que descrevem atributos de pelos faciais.
gender	Gender	Possível sexo do rosto.
glasses	GlassesType	Óculos digitam se qualquer um dos rostos.
hair	Hair	Propriedades que descrevem atributos de cabelo.
headPose	HeadPose	Propriedades que indicam a pose da cabeça do rosto.
makeup	Makeup	Propriedades que descrevem a presença de maquiagem em um determinado rosto.
mask	Mask	Propriedades que descrevem a presença de uma máscara em um determinado rosto.
noise	Noise	Propriedades que descrevem o nível de ruído da imagem.
occlusion	Occlusion	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 minimum: 0 maximum: 1	Intensidade do sorriso, um número entre [0,1]

FaceAttributeType

Enumeração

Analise e retorne um ou mais atributos de rosto especificados na cadeia de caracteres separada por vírgulas, como "returnFaceAttributes=age,gender". Os atributos disponíveis dependem do 'detectionModel' especificado. 'detection_01' dá suporte à idade, sexo, headPose, sorriso, facialHair, óculos, emoção, cabelo, maquiagem, oclusão, acessórios, desfoque, exposição, ruído e qualidadeForRecognition. Embora o 'detection_02' não dê suporte a nenhum atributo e "detection_03" dê suporte apenas à máscara e à qualidadeForRecognition. Além disso, qualityForRecognition só tem suporte quando o 'recognitionModel' é especificado como 'recognition_03' ou 'recognition_04'. Observe que cada análise de atributo facial tem custo computacional e de tempo adicionais.

Valor	Description
accessories
age
blur
emotion
exposure
facialHair
gender
glasses
hair
headPose
makeup
mask
noise
occlusion
qualityForRecognition
smile

FaceLandmarks

Objeto

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	Coordinate	Coordenadas dentro de uma imagem
eyeLeftInner	Coordinate	Coordenadas dentro de uma imagem
eyeLeftOuter	Coordinate	Coordenadas dentro de uma imagem
eyeLeftTop	Coordinate	Coordenadas dentro de uma imagem
eyeRightBottom	Coordinate	Coordenadas dentro de uma imagem
eyeRightInner	Coordinate	Coordenadas dentro de uma imagem
eyeRightOuter	Coordinate	Coordenadas dentro de uma imagem
eyeRightTop	Coordinate	Coordenadas dentro de uma imagem
eyebrowLeftInner	Coordinate	Coordenadas dentro de uma imagem
eyebrowLeftOuter	Coordinate	Coordenadas dentro de uma imagem
eyebrowRightInner	Coordinate	Coordenadas dentro de uma imagem
eyebrowRightOuter	Coordinate	Coordenadas dentro de uma imagem
mouthLeft	Coordinate	Coordenadas dentro de uma imagem
mouthRight	Coordinate	Coordenadas dentro de uma imagem
noseLeftAlarOutTip	Coordinate	Coordenadas dentro de uma imagem
noseLeftAlarTop	Coordinate	Coordenadas dentro de uma imagem
noseRightAlarOutTip	Coordinate	Coordenadas dentro de uma imagem
noseRightAlarTop	Coordinate	Coordenadas dentro de uma imagem
noseRootLeft	Coordinate	Coordenadas dentro de uma imagem
noseRootRight	Coordinate	Coordenadas dentro de uma imagem
noseTip	Coordinate	Coordenadas dentro de uma imagem
pupilLeft	Coordinate	Coordenadas dentro de uma imagem
pupilRight	Coordinate	Coordenadas dentro de uma imagem
underLipBottom	Coordinate	Coordenadas dentro de uma imagem
underLipTop	Coordinate	Coordenadas dentro de uma imagem
upperLipBottom	Coordinate	Coordenadas dentro de uma imagem
upperLipTop	Coordinate	Coordenadas dentro de uma imagem

FaceRectangle

Objeto

Um retângulo no qual um rosto pode ser encontrado

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

FacialHair

Objeto

Propriedades que descrevem atributos de pelos faciais.

Nome	Tipo	Description
beard	number 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 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 minimum: 0 maximum: 1	Um número que varia de 0 a 1 indicando um nível de confiança associado a uma propriedade.

Gender

Enumeração

Possível sexo do rosto.

Valor	Description
female
male

GlassesType

Enumeração

Óculos digitam se qualquer um dos rostos.

Valor	Description
noGlasses
readingGlasses
sunglasses
swimmingGoggles

Hair

Objeto

Propriedades que descrevem atributos de cabelo.

Nome	Tipo	Description
bald	number minimum: 0 maximum: 1	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.

HairColor

Objeto

Cor do cabelo e confiança associada

Nome	Tipo	Description
color	HairColorType	Nome da cor do cabelo.
confidence	number minimum: 0 maximum: 1	Nível de confiança da cor

HairColorType

Enumeração

Nome da cor do cabelo.

Valor	Description
black
blond
brown
gray
other
red
unknown
white

HeadPose

Objeto

Propriedades que indicam a pose da cabeça do rosto.

Nome	Tipo	Description
pitch	number
roll	number
yaw	number

ImageUrl

Objeto

Nome	Tipo	Description
url	string	URL acessível publicamente de uma imagem

Makeup

Objeto

Propriedades que descrevem a presença de maquiagem em um determinado rosto.

Nome	Tipo	Description
eyeMakeup	boolean	Um valor booliano que descreve se a maquiagem ocular está presente em um rosto.
lipMakeup	boolean	Um valor booliano que descreve se a maquiagem labial está presente em um rosto.

Mask

Objeto

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 de máscara se qualquer um dos rostos

MaskType

Enumeração

Tipo de máscara se qualquer um dos rostos

Valor	Description
faceMask
noMask
otherMaskOrOcclusion
uncertain

Noise

Objeto

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 minimum: 0 maximum: 1	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.

NoiseLevel

Enumeração

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

Valor	Description
High
Low
Medium

Occlusion

Objeto

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

Enumeração

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.

Valor	Description
High
Low
Medium

RecognitionModel

Enumeração

Nome do modelo de reconhecimento. O modelo de reconhecimento é usado quando os recursos de rosto são extraídos e associados a faceIds detectadas, (Large)FaceList ou (Large)PersonGroup. Um nome de modelo de reconhecimento pode ser fornecido ao executar Face - Detect ou (Large)FaceList - Create or (Large)PersonGroup - Create. O valor padrão é 'recognition_01', se o modelo mais recente for necessário, especifique explicitamente o modelo necessário.

Valor	Description
recognition_01
recognition_02
recognition_03
recognition_04

Compartilhar via

Face - Detect With Url

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Detect with url example

Solicitação de exemplo

Resposta de exemplo

Definições

Accessory

AccessoryType

APIError

Blur

BlurLevel

Coordinate

DetectedFace

DetectionModel

Emotion

Error

Exposure

ExposureLevel

FaceAttributes

FaceAttributeType

FaceLandmarks

FaceRectangle

FacialHair

Gender

GlassesType

Hair

HairColor

HairColorType

HeadPose

ImageUrl

Makeup

Mask

MaskType

Noise

NoiseLevel

Occlusion

QualityForRecognition

RecognitionModel