Face - Detect With Url

Referencia

Servicio:: Azure AI Services

Versión de la API:: 1.0

Detecte caras humanas en una imagen, devuelva rectángulos faciales y, opcionalmente, con faceIds, puntos de referencia y atributos.

No se almacenará ninguna imagen. Solo la característica de cara extraída se almacenará en el servidor. FaceId es un identificador de la característica de cara y se usará en Cara: identificar, Cara - Comprobary Cara - Buscarsimilar. Las características faciales almacenadas expirarán y se eliminarán en el momento especificado por faceIdTimeToLive después de la llamada de detección original.
Los parámetros opcionales incluyen faceId, puntos de referencia y atributos. Los atributos incluyen edad, sexo, headPose, sonrisa, facialHair, gafas, emociones, cabello, maquillaje, oclusión, accesorios, desenfoque, exposición, ruido, máscara y calidadForRecognition. Es posible que algunos de los resultados devueltos para atributos específicos no sean muy precisos.
Se admiten formato JPEG, PNG, GIF (el primer fotograma) y BMP. El tamaño de archivo de imagen permitido es de 1 KB a 6 MB.
Se pueden devolver hasta 100 caras para una imagen. Las caras se clasifican por tamaño de rectángulo facial de grande a pequeño.
Para obtener resultados óptimos al consultar Face- Identificar, Cara - Comprobary Cara - Buscar similar ("returnFaceId" es true), use caras que son: frontal, clara y con un tamaño mínimo de 200 x 2000 píxeles (100 píxeles entre los ojos).
El tamaño mínimo de cara detectable es de 36 x 36 píxeles en una imagen que no supera los 1920 x 1080 píxeles. Las imágenes con dimensiones superiores a 1920x1080 píxeles necesitarán un tamaño mínimo de cara proporcionalmente mayor.
Se pueden proporcionar valores 'detectionModel'. Para usar y comparar diferentes modelos de detección, consulte Cómo especificar un modelo de detección.
Se proporcionan distintos valores de "recognitionModel". Si se necesitan operaciones de seguimiento como Verify, Identify, Find Similar, especifique el modelo de reconocimiento con el parámetro "recognitionModel". El valor predeterminado de "recognitionModel" es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita en este parámetro. Una vez especificado, los faceId detectados se asociarán al modelo de reconocimiento especificado. Para obtener más información, consulte Especificar un modelo de reconocimiento.

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

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
detectionModel	query		DetectionModel	Nombre del modelo de detección. El modelo de detección se usa para detectar caras en la imagen enviada. Se puede proporcionar un nombre de modelo de detección al realizar Face - Detect o (Large)FaceList - Add Face o (Large)PersonGroup - Add Face. El valor predeterminado es "detection_01", si se necesita otro modelo, especifíquelo explícitamente.
faceIdTimeToLive	query		integer minimum: 60 maximum: 86400	Número de segundos para el faceId que se almacena en caché. Intervalo admitido de 60 segundos hasta 86400 segundos. El valor predeterminado es 86400 (24 horas).
recognitionModel	query		RecognitionModel	Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando las características faciales se extraen y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.
returnFaceAttributes	query		FaceAttributeType[]	Analice y devuelva los atributos de cara especificados en la cadena separada por comas como "returnFaceAttributes=age,gender". Los atributos disponibles dependen del especificado "detectionModel". 'detection_01' admite edad, sexo, headPose, sonrisa, facialHair, gafas, emoción, cabello, maquillaje, oclusión, accesorios, desenfoque, exposición, ruido y calidadForRecognition. Aunque "detection_02" no admite ningún atributo y "detection_03" solo admite mask y qualityForRecognition. Además, qualityForRecognition solo se admite cuando se especifica "recognitionModel" como "recognition_03" o "recognition_04". Tenga en cuenta que cada análisis de atributos faciales tiene costos de cálculo y tiempo adicionales.
returnFaceId	query		boolean	Valor que indica si la operación debe devolver faceIds de caras detectadas. La detección con este valor establecido en true requiere aprobaciones de acceso adicionales en https://aka.ms/facerecognition.
returnFaceLandmarks	query		boolean	Valor que indica si la operación debe devolver puntos de referencia de las caras detectadas.
returnRecognitionModel	query		boolean	Valor que indica si la operación debe devolver "recognitionModel" en respuesta.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
url	True	string	Dirección URL accesible públicamente de una imagen

Respuestas

Nombre	Tipo	Description
200 OK	DetectedFace[]	Una llamada correcta devuelve una matriz de entradas faciales clasificadas por tamaño de rectángulo facial en orden descendente. Una respuesta vacía indica que no se han detectado caras.
Other Status Codes	APIError	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Detect with url example

Solicitud de ejemplo

HTTP

POST {Endpoint}/face/v1.0/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}"
}

Respuesta de muestra

status code:: 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
      }
    }
  }
]

Definiciones

Nombre	Description
Accessory	Elemento accesorio y nivel de confianza correspondiente.
AccessoryType	Tipo de accesorio
APIError	Información de error devuelta por la API
Blur	Propiedades que describen cualquier presencia de desenfoque dentro de la imagen.
BlurLevel	Valor de enumeración que indica el nivel de desenfoque.
Coordinate	Coordenadas dentro de una imagen
DetectedFace	Objeto Face detectado.
DetectionModel	Nombre del modelo de detección. El modelo de detección se usa para detectar caras en la imagen enviada. Se puede proporcionar un nombre de modelo de detección al realizar Face - Detect o (Large)FaceList - Add Face o (Large)PersonGroup - Add Face. El valor predeterminado es "detection_01", si se necesita otro modelo, especifíquelo explícitamente.
Emotion	Propiedades que describen las emociones faciales en forma de confianza que van de 0 a 1.
Error	Cuerpo del error.
Exposure	Propiedades que describen el nivel de exposición de la imagen.
ExposureLevel	Valor de enumeración que indica el nivel de exposición.
FaceAttributes	Atributos de face
FaceAttributeType	Analice y devuelva los atributos de cara especificados en la cadena separada por comas como "returnFaceAttributes=age,gender". Los atributos disponibles dependen del especificado "detectionModel". 'detection_01' admite edad, sexo, headPose, sonrisa, facialHair, gafas, emoción, cabello, maquillaje, oclusión, accesorios, desenfoque, exposición, ruido y calidadForRecognition. Aunque "detection_02" no admite ningún atributo y "detection_03" solo admite mask y qualityForRecognition. Además, qualityForRecognition solo se admite cuando se especifica "recognitionModel" como "recognition_03" o "recognition_04". Tenga en cuenta que cada análisis de atributos faciales tiene costos de cálculo y tiempo adicionales.
FaceLandmarks	Colección de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales.
FaceRectangle	Rectángulo dentro del cual se puede encontrar una cara
FacialHair	Propiedades que describen los atributos del cabello facial.
Gender	Posible género de la cara.
GlassesType	Las gafas escriben si alguna de las caras.
Hair	Propiedades que describen atributos de cabello.
HairColor	Color del cabello y confianza asociada
HairColorType	Nombre del color del cabello.
HeadPose	Propiedades que indican la posición de la cabeza de la cara.
ImageUrl
Makeup	Propiedades que describen la presencia de maquillaje en una cara determinada.
Mask	Propiedades que describen la presencia de una máscara en una cara determinada.
MaskType	Tipo de máscara si alguno de los rostros
Noise	Propiedades que describen el nivel de ruido de la imagen.
NoiseLevel	Valor de enumeración que indica el nivel de ruido.
Occlusion	Propiedades que describen las oclusiones en una cara determinada.
QualityForRecognition	Valor de enumeración que indica la calidad de la imagen para el reconocimiento.
RecognitionModel	Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando las características faciales se extraen y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

Accessory

Object

Elemento accesorio y nivel de confianza correspondiente.

Nombre	Tipo	Description
confidence	number minimum: 0 maximum: 1	Nivel de confianza de un accesorio
type	AccessoryType	Tipo de accesorio

AccessoryType

Enumeración

Tipo de accesorio

Valor	Description
glasses
headWear
mask

APIError

Object

Información de error devuelta por la API

Nombre	Tipo	Description
error	Error	Cuerpo del error.

Blur

Object

Propiedades que describen cualquier presencia de desenfoque dentro de la imagen.

Nombre	Tipo	Description
blurLevel	BlurLevel	Valor de enumeración que indica el nivel de desenfoque.
value	number minimum: 0 maximum: 1	Número que indica el nivel de desenfoque que va de 0 a 1.

BlurLevel

Enumeración

Valor de enumeración que indica el nivel de desenfoque.

Valor	Description
High
Low
Medium

Coordinate

Object

Coordenadas dentro de una imagen

Nombre	Tipo	Description
x	number	Componente horizontal, en píxeles.
y	number	Componente vertical, en píxeles.

DetectedFace

Object

Objeto Face detectado.

Nombre	Tipo	Valor predeterminado	Description
faceAttributes	FaceAttributes		Atributos de face
faceId	string (uuid)
faceLandmarks	FaceLandmarks		Colección de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales.
faceRectangle	FaceRectangle		Rectángulo dentro del cual se puede encontrar una cara
recognitionModel	RecognitionModel	recognition_01	Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando las características faciales se extraen y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

DetectionModel

Enumeración

Nombre del modelo de detección. El modelo de detección se usa para detectar caras en la imagen enviada. Se puede proporcionar un nombre de modelo de detección al realizar Face - Detect o (Large)FaceList - Add Face o (Large)PersonGroup - Add Face. El valor predeterminado es "detection_01", si se necesita otro modelo, especifíquelo explícitamente.

Valor	Description
detection_01
detection_02
detection_03

Emotion

Object

Propiedades que describen las emociones faciales en forma de confianza que van de 0 a 1.

Nombre	Tipo	Description
anger	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
contempt	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
disgust	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
fear	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
happiness	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
neutral	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
sadness	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
surprise	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.

Error

Object

Cuerpo del error.

Nombre	Tipo	Description
code	string
message	string

Exposure

Object

Propiedades que describen el nivel de exposición de la imagen.

Nombre	Tipo	Description
exposureLevel	ExposureLevel	Valor de enumeración que indica el nivel de exposición.
value	number minimum: 0 maximum: 1	Número que indica el nivel de exposición comprendido entre 0 y 1. [0, 0,25) está bajo exposición. [0.25, 0.75) es una buena exposición. [0,75, 1] está por encima de la exposición.

ExposureLevel

Enumeración

Valor de enumeración que indica el nivel de exposición.

Valor	Description
GoodExposure
OverExposure
UnderExposure

FaceAttributes

Object

Atributos de face

Nombre	Tipo	Description
accessories	Accessory[]	Propiedades que describen cualquier accesorios en una cara determinada.
age	number	Edad en años
blur	Blur	Propiedades que describen cualquier presencia de desenfoque dentro de la imagen.
emotion	Emotion	Propiedades que describen las emociones faciales en forma de confianza que van de 0 a 1.
exposure	Exposure	Propiedades que describen el nivel de exposición de la imagen.
facialHair	FacialHair	Propiedades que describen los atributos del cabello facial.
gender	Gender	Posible género de la cara.
glasses	GlassesType	Las gafas escriben si alguna de las caras.
hair	Hair	Propiedades que describen atributos de cabello.
headPose	HeadPose	Propiedades que indican la posición de la cabeza de la cara.
makeup	Makeup	Propiedades que describen la presencia de maquillaje en una cara determinada.
mask	Mask	Propiedades que describen la presencia de una máscara en una cara determinada.
noise	Noise	Propiedades que describen el nivel de ruido de la imagen.
occlusion	Occlusion	Propiedades que describen las oclusiones en una cara determinada.
qualityForRecognition	QualityForRecognition	Propiedades que describen la calidad general de la imagen con respecto a si la imagen que se usa en la detección es de calidad suficiente para intentar el reconocimiento facial.
smile	number minimum: 0 maximum: 1	Intensidad de la sonrisa, un número entre [0,1]

FaceAttributeType

Enumeración

Analice y devuelva los atributos de cara especificados en la cadena separada por comas como "returnFaceAttributes=age,gender". Los atributos disponibles dependen del especificado "detectionModel". 'detection_01' admite edad, sexo, headPose, sonrisa, facialHair, gafas, emoción, cabello, maquillaje, oclusión, accesorios, desenfoque, exposición, ruido y calidadForRecognition. Aunque "detection_02" no admite ningún atributo y "detection_03" solo admite mask y qualityForRecognition. Además, qualityForRecognition solo se admite cuando se especifica "recognitionModel" como "recognition_03" o "recognition_04". Tenga en cuenta que cada análisis de atributos faciales tiene costos de cálculo y tiempo adicionales.

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

FaceLandmarks

Object

Colección de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales.

Nombre	Tipo	Description
eyeLeftBottom	Coordinate	Coordenadas dentro de una imagen
eyeLeftInner	Coordinate	Coordenadas dentro de una imagen
eyeLeftOuter	Coordinate	Coordenadas dentro de una imagen
eyeLeftTop	Coordinate	Coordenadas dentro de una imagen
eyeRightBottom	Coordinate	Coordenadas dentro de una imagen
eyeRightInner	Coordinate	Coordenadas dentro de una imagen
eyeRightOuter	Coordinate	Coordenadas dentro de una imagen
eyeRightTop	Coordinate	Coordenadas dentro de una imagen
eyebrowLeftInner	Coordinate	Coordenadas dentro de una imagen
eyebrowLeftOuter	Coordinate	Coordenadas dentro de una imagen
eyebrowRightInner	Coordinate	Coordenadas dentro de una imagen
eyebrowRightOuter	Coordinate	Coordenadas dentro de una imagen
mouthLeft	Coordinate	Coordenadas dentro de una imagen
mouthRight	Coordinate	Coordenadas dentro de una imagen
noseLeftAlarOutTip	Coordinate	Coordenadas dentro de una imagen
noseLeftAlarTop	Coordinate	Coordenadas dentro de una imagen
noseRightAlarOutTip	Coordinate	Coordenadas dentro de una imagen
noseRightAlarTop	Coordinate	Coordenadas dentro de una imagen
noseRootLeft	Coordinate	Coordenadas dentro de una imagen
noseRootRight	Coordinate	Coordenadas dentro de una imagen
noseTip	Coordinate	Coordenadas dentro de una imagen
pupilLeft	Coordinate	Coordenadas dentro de una imagen
pupilRight	Coordinate	Coordenadas dentro de una imagen
underLipBottom	Coordinate	Coordenadas dentro de una imagen
underLipTop	Coordinate	Coordenadas dentro de una imagen
upperLipBottom	Coordinate	Coordenadas dentro de una imagen
upperLipTop	Coordinate	Coordenadas dentro de una imagen

FaceRectangle

Object

Rectángulo dentro del cual se puede encontrar una cara

Nombre	Tipo	Description
height	integer (int32)	Alto del rectángulo, en píxeles.
left	integer (int32)	Distancia desde el borde izquierdo si la imagen al borde izquierdo del rectángulo, en píxeles.
top	integer (int32)	Distancia desde el borde superior si la imagen hasta el borde superior del rectángulo, en píxeles.
width	integer (int32)	Ancho del rectángulo, en píxeles.

FacialHair

Object

Propiedades que describen los atributos del cabello facial.

Nombre	Tipo	Description
beard	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
moustache	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
sideburns	number minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.

Gender

Enumeración

Posible género de la cara.

Valor	Description
female
male

GlassesType

Enumeración

Las gafas escriben si alguna de las caras.

Valor	Description
noGlasses
readingGlasses
sunglasses
swimmingGoggles

Hair

Object

Propiedades que describen atributos de cabello.

Nombre	Tipo	Description
bald	number minimum: 0 maximum: 1	Número que describe el nivel de confianza de si la persona es calva.
hairColor	HairColor[]	Matriz de colores candidatos y nivel de confianza en presencia de cada uno.
invisible	boolean	Valor booleano que describe si el cabello está visible en la imagen.

HairColor

Object

Color del cabello y confianza asociada

Nombre	Tipo	Description
color	HairColorType	Nombre del color del cabello.
confidence	number minimum: 0 maximum: 1	Nivel de confianza del color

HairColorType

Enumeración

Nombre del color del cabello.

Valor	Description
black
blond
brown
gray
other
red
unknown
white

HeadPose

Object

Propiedades que indican la posición de la cabeza de la cara.

Nombre	Tipo	Description
pitch	number
roll	number
yaw	number

ImageUrl

Object

Nombre	Tipo	Description
url	string	Dirección URL accesible públicamente de una imagen

Makeup

Object

Propiedades que describen la presencia de maquillaje en una cara determinada.

Nombre	Tipo	Description
eyeMakeup	boolean	Valor booleano que describe si el maquillaje ocular está presente en una cara.
lipMakeup	boolean	Valor booleano que describe si el maquillaje de labios está presente en una cara.

Mask

Object

Propiedades que describen la presencia de una máscara en una cara determinada.

Nombre	Tipo	Description
noseAndMouthCovered	boolean	Valor booleano que indica si la nariz y la boca están cubiertas.
type	MaskType	Tipo de máscara si alguno de los rostros

MaskType

Enumeración

Tipo de máscara si alguno de los rostros

Valor	Description
faceMask
noMask
otherMaskOrOcclusion
uncertain

Noise

Object

Propiedades que describen el nivel de ruido de la imagen.

Nombre	Tipo	Description
noiseLevel	NoiseLevel	Valor de enumeración que indica el nivel de ruido.
value	number minimum: 0 maximum: 1	Número que indica el nivel de ruido comprendido entre 0 y 1. [0, 0,25) está bajo exposición. [0.25, 0.75) es una buena exposición. [0,75, 1] está por encima de la exposición. [0, 0,3) es bajo nivel de ruido. [0.3, 0.7) es un nivel de ruido medio. [0.7, 1] es de alto nivel de ruido.

NoiseLevel

Enumeración

Valor de enumeración que indica el nivel de ruido.

Valor	Description
High
Low
Medium

Occlusion

Object

Propiedades que describen las oclusiones en una cara determinada.

Nombre	Tipo	Description
eyeOccluded	boolean	Valor booleano que indica si los ojos están ocluidos.
foreheadOccluded	boolean	Valor booleano que indica si la frente está ocluida.
mouthOccluded	boolean	Valor booleano que indica si la boca está ocluida.

QualityForRecognition

Enumeración

Valor de enumeración que indica la calidad de la imagen para el reconocimiento.

Valor	Description
High
Low
Medium

RecognitionModel

Enumeración

Nombre del modelo de reconocimiento. El modelo de reconocimiento se usa cuando las características faciales se extraen y se asocian a faceIds detectados, (Large)FaceList o (Large)PersonGroup. Se puede proporcionar un nombre de modelo de reconocimiento al realizar Face - Detect o (Large)FaceList - Create o (Large)PersonGroup - Create. El valor predeterminado es "recognition_01", si es necesario el modelo más reciente, especifique explícitamente el modelo que necesita.

Valor	Description
recognition_01
recognition_02
recognition_03
recognition_04

Compartir a través de

Face - Detect With Url

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Detect with url example

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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