Face Detection Operations - Detect

Referencia

Servicio:: Azure AI Services

Versión de la API:: v1.2

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

Importante

Microsoft ha retirado o limitado las funcionalidades de reconocimiento facial que se pueden usar para intentar deducir los estados emocionales y los atributos de identidad que, si se usan incorrectamente, pueden someter a personas a estereotipos, discriminación o denegación de servicios injustos. Las funcionalidades retiradas son emociones y géneros. Las capacidades limitadas son edad, sonrisa, cabello facial, cabello y maquillaje. Correo electrónico Azure Face API si tiene un caso de uso responsable que se beneficiaría del uso de cualquiera de las funcionalidades limitadas. Obtenga más información sobre esta decisión aquí.

- No se almacenará ninguna imagen. Solo las características faciales extraídas se almacenarán en el servidor. FaceId es un identificador de la característica de cara y se usará en "Identificar", "Comprobar" y "Buscar similar". Las características de caras 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 headPose, gafas, 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.
- 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 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 "Identificar", "Comprobar" y "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).
- Se pueden proporcionar valores 'detectionModel'. La disponibilidad de puntos de referencia y atributos admitidos depende del modelo de detección especificado. Para usar y comparar diferentes modelos de detección, consulte aquí.
- 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 aquí.

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

Con parámetros opcionales:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
apiVersion	path	True	string	Versión de API
endpoint	path	True	string (uri)	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://{resource-name}.cognitiveservices.azure.com).
detectionModel	query		DetectionModel	"detectionModel" asociado a los faceId detectados. Los valores admitidos de "detectionModel" incluyen "detection_01", "detection_02" y "detection_03". El valor predeterminado es "detection_01". Se recomienda "detection_03", ya que su precisión se mejora en las caras más pequeñas (64 x 64 píxeles) y las orientaciones de cara giradas.
faceIdTimeToLive	query		integer (int32) minimum: 60 maximum: 86400	Número de segundos para el identificador de cara que se almacena en caché. Intervalo admitido de 60 segundos hasta 86400 segundos. El valor predeterminado es 86400 (24 horas).
recognitionModel	query		RecognitionModel	"recognitionModel" asociado a los faceId detectados. Los valores admitidos de "recognitionModel" incluyen "recognition_01", "recognition_02", "recognition_03" o "recognition_04". El valor predeterminado es "recognition_01". Se recomienda "recognition_04", ya que su precisión se mejora en las caras que usan máscaras en comparación con "recognition_03", y su precisión general se mejora en comparación con "recognition_01" y "recognition_02".
returnFaceAttributes	query		FaceAttributeType[]	Analice y devuelva los atributos de cara especificados en la cadena separada por comas, como "returnFaceAttributes=headPose,glasses". El análisis de atributos de Face tiene costos de cálculo y tiempo adicionales.
returnFaceId	query		boolean	Devuelve faceIds de las caras detectadas o no. El valor predeterminado es true.
returnFaceLandmarks	query		boolean	Devuelve los puntos de referencia de la cara de las caras detectadas o no. El valor predeterminado es false.
returnRecognitionModel	query		boolean	Devuelve 'recognitionModel' o no. El valor predeterminado es false. Esto solo es aplicable cuando returnFaceId = true.

Cuerpo de la solicitud

Media Types: "application/octet-stream"

Nombre	Tipo	Description
imageContent	string (binary)	Binario de la imagen de entrada.

Respuestas

Nombre	Tipo	Description
200 OK	FaceDetectionResult[]	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	FaceErrorResponse	Una respuesta de error inesperada. Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

FaceDetectionResult[]

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

FaceErrorResponse

Una respuesta de error inesperada.

Encabezados

x-ms-error-code: string

Seguridad

Ocp-Apim-Subscription-Key

Clave secreta de la suscripción de Azure AI Face.

Tipo: apiKey
En: header

AADToken

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://api.example.com/oauth2/authorize
Dirección URL del token: https://api.example.com/oauth2/token

Ámbitos

Nombre	Description
https://cognitiveservices.azure.com/.default

Ejemplos

Detect with Image

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
AccessoryItem	Elemento accesorio y nivel de confianza correspondiente.
AccessoryType	Tipo del accesorio.
BlurLevel	Indica el nivel de desenfoque.
BlurProperties	Propiedades que describen cualquier presencia de desenfoque dentro de la imagen.
DetectionModel	"detectionModel" asociado a los faceId detectados. Los valores admitidos de "detectionModel" incluyen "detection_01", "detection_02" y "detection_03". El valor predeterminado es "detection_01". Se recomienda "detection_03", ya que su precisión se mejora en las caras más pequeñas (64 x 64 píxeles) y las orientaciones de cara giradas.
ExposureLevel	Indica el nivel de exposición.
ExposureProperties	Propiedades que describen el nivel de exposición de la imagen.
FaceAttributes	Atributos de cara para la cara detectada.
FaceAttributeType	Analice y devuelva los atributos de cara especificados en la cadena separada por comas, como "returnFaceAttributes=headPose,glasses". El análisis de atributos de Face tiene costos de cálculo y tiempo adicionales.
FaceDetectionResult	Respuesta para detectar api.
FaceError	Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el vínculo siguiente: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Respuesta que contiene los detalles del error.
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.
GlassesType	Gafas tipo de cara.
HairColor	Matriz de colores candidatos y nivel de confianza en presencia de cada uno.
HairColorType	Nombre del color del cabello.
HairProperties	Propiedades que describen atributos de cabello.
HeadPose	Ángulos de giro/giro/inclinación 3D para la dirección de la cara.
LandmarkCoordinate	Coordenadas de punto de referencia dentro de una imagen.
MaskProperties	Propiedades que describen la presencia de una máscara en una cara determinada.
MaskType	Tipo de la máscara.
NoiseLevel	Indica el nivel de ruido.
NoiseProperties	Propiedades que describen el nivel de ruido de la imagen.
OcclusionProperties	Propiedades que describen las oclusiones en una cara determinada.
QualityForRecognition	Indica la calidad de la imagen para el reconocimiento.
RecognitionModel	Modelo de reconocimiento para la cara.

AccessoryItem

Object

Elemento accesorio y nivel de confianza correspondiente.

Nombre	Tipo	Description
confidence	number (float) minimum: 0 maximum: 1	Nivel de confianza del tipo de accesorio. Intervalo entre [0,1].
type	AccessoryType	Tipo del accesorio.

AccessoryType

Enumeración

Tipo del accesorio.

Valor	Description
glasses	Gafas.
headwear	Desgaste de la cabeza.
mask	Máscara.

BlurLevel

Enumeración

Indica el nivel de desenfoque.

Valor	Description
high	Alto nivel de desenfoque.
low	Nivel de desenfoque bajo.
medium	Nivel de desenfoque medio.

BlurProperties

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 (float) minimum: 0 maximum: 1	Número que indica el nivel de desenfoque que va de 0 a 1.

DetectionModel

Enumeración

"detectionModel" asociado a los faceId detectados. Los valores admitidos de "detectionModel" incluyen "detection_01", "detection_02" y "detection_03". El valor predeterminado es "detection_01". Se recomienda "detection_03", ya que su precisión se mejora en las caras más pequeñas (64 x 64 píxeles) y las orientaciones de cara giradas.

Valor	Description
detection_01	Modelo de detección predeterminado. Se recomienda para la detección de caras frontales cercanas. En el caso de escenarios con caras de ángulo excepcionalmente grande (posición de cabeza), caras ocluidas o orientación incorrecta de la imagen, es posible que no se detecten las caras en tales casos.
detection_02	Modelo de detección publicado en mayo de 2019 con una precisión mejorada especialmente en caras pequeñas, laterales y borrosas.
detection_03	Modelo de detección publicado en febrero de 2021 con una precisión mejorada especialmente en caras pequeñas.

ExposureLevel

Enumeración

Indica el nivel de exposición.

Valor	Description
goodExposure	Buen nivel de exposición.
overExposure	Alto nivel de exposición.
underExposure	Nivel de exposición bajo.

ExposureProperties

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 (float) 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.

FaceAttributes

Object

Atributos de cara para la cara detectada.

Nombre	Tipo	Description
accessories	AccessoryItem[]	Propiedades que describen cualquier accesorios en una cara determinada.
age	number (float)	Edad en años.
blur	BlurProperties	Propiedades que describen cualquier presencia de desenfoque dentro de la imagen.
exposure	ExposureProperties	Propiedades que describen el nivel de exposición de la imagen.
facialHair	FacialHair	Propiedades que describen los atributos del cabello facial.
glasses	GlassesType	Las gafas escriben si alguna de las caras.
hair	HairProperties	Propiedades que describen atributos de cabello.
headPose	HeadPose	Ángulos de giro/giro/inclinación 3D para la dirección de la cara.
mask	MaskProperties	Propiedades que describen la presencia de una máscara en una cara determinada.
noise	NoiseProperties	Propiedades que describen el nivel de ruido de la imagen.
occlusion	OcclusionProperties	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 (float) 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=headPose,glasses". El análisis de atributos de Face tiene costos de cálculo y tiempo adicionales.

Valor	Description
accessories	Accesorios alrededor de la cara, incluyendo 'headwear', 'gafas' y 'mask'. Matriz vacía significa que no se han detectado accesorios. Tenga en cuenta que esto es después de que se detecte una cara. La máscara grande podría dar lugar a que no se detecte ninguna cara.
age	Edad en años.
blur	La cara es borrosa o no. Level devuelve "Low", "Medium" o "High". El valor devuelve un número entre [0,1], cuanto mayor sea el borroso.
exposure	Nivel de exposición facial. Level devuelve "GoodExposure", "OverExposure" o "UnderExposure".
facialHair	Propiedades que describen los atributos del cabello facial.
glasses	Tipo de gafas. Los valores incluyen "NoGlasses", "ReadingGlasses", "Gafas de sol", "SwimmingGoggles".
hair	Propiedades que describen atributos de cabello.
headPose	Ángulos de giro/giro/inclinación 3D para la dirección de la cara.
mask	Si cada cara está usando una máscara. El tipo de máscara devuelve "noMask", "faceMask", "otherMaskOrOcclusion" o "incierta". El valor devuelve un valor booleano 'noseAndMouthCovered' que indica si la nariz y la boca están cubiertas.
noise	Nivel de ruido de píxeles de cara. Level devuelve "Low", "Medium" y "High". El valor devuelve un número entre [0,1], cuanto mayor sea el ruidoso.
occlusion	Si cada área facial está ocluida, incluyendo la frente, los ojos y la boca.
qualityForRecognition	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. El valor es una clasificación informal de baja, media o alta. Solo se recomiendan imágenes de alta calidad para la inscripción de personas y la calidad en o superior a "medio" para escenarios de identificación. El atributo solo está disponible cuando se usan modelos de reconocimiento recognition_03 o recognition_04.
smile	Intensidad de la sonrisa, un número entre [0,1].

FaceDetectionResult

Object

Respuesta para detectar api.

Nombre	Tipo	Description
faceAttributes	FaceAttributes	Atributos de cara para la cara detectada.
faceId	string (uuid)	FaceId único de la cara detectada, creada por la API de detección y expirará 24 horas después de la llamada de detección. Para devolver esto, requiere que el parámetro "returnFaceId" sea true.
faceLandmarks	FaceLandmarks	Matriz de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales. Para devolver esto, requiere que el parámetro "returnFaceLandmarks" sea true.
faceRectangle	FaceRectangle	Área de rectángulo para la ubicación de la cara en la imagen.
recognitionModel	RecognitionModel	"recognitionModel" asociado a este faceId. Esto solo se devuelve cuando 'returnRecognitionModel' se establece explícitamente como true.

FaceError

Object

Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el vínculo siguiente: https://aka.ms/face-error-codes-and-messages.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
message	string	Representación legible del error.

FaceErrorResponse

Object

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	FaceError	Objeto de error.

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	LandmarkCoordinate	Coordenadas de la parte inferior izquierda del ojo.
eyeLeftInner	LandmarkCoordinate	Coordenadas del ojo izquierdo interno.
eyeLeftOuter	LandmarkCoordinate	Coordenadas del ojo izquierdo exterior.
eyeLeftTop	LandmarkCoordinate	Coordenadas de la parte superior izquierda.
eyeRightBottom	LandmarkCoordinate	Coordenadas de la parte inferior derecha del ojo.
eyeRightInner	LandmarkCoordinate	Coordenadas del ojo derecho interno.
eyeRightOuter	LandmarkCoordinate	Coordenadas del ojo derecho exterior.
eyeRightTop	LandmarkCoordinate	Coordenadas de la parte superior derecha del ojo.
eyebrowLeftInner	LandmarkCoordinate	Coordenadas de la ceja izquierda interna.
eyebrowLeftOuter	LandmarkCoordinate	Coordenadas de la ceja izquierda exterior.
eyebrowRightInner	LandmarkCoordinate	Coordenadas de la ceja derecha interna.
eyebrowRightOuter	LandmarkCoordinate	Coordenadas de la ceja derecha exterior.
mouthLeft	LandmarkCoordinate	Coordenadas de la boca izquierda.
mouthRight	LandmarkCoordinate	Coordenadas de la boca derecha.
noseLeftAlarOutTip	LandmarkCoordinate	Las coordenadas de la nariz dejaron la punta alar hacia fuera.
noseLeftAlarTop	LandmarkCoordinate	Coordenadas de la nariz izquierda alar top.
noseRightAlarOutTip	LandmarkCoordinate	Coordenadas de la punta derecha de la nariz.
noseRightAlarTop	LandmarkCoordinate	Coordenadas de la parte superior derecha de la nariz.
noseRootLeft	LandmarkCoordinate	Coordenadas de la raíz de la nariz a la izquierda.
noseRootRight	LandmarkCoordinate	Coordenadas de la raíz de la nariz a la derecha.
noseTip	LandmarkCoordinate	Coordenadas de la punta de la nariz.
pupilLeft	LandmarkCoordinate	Coordenadas de la pupila del ojo izquierdo.
pupilRight	LandmarkCoordinate	Coordenadas de la pupila del ojo derecho.
underLipBottom	LandmarkCoordinate	Coordenadas de la parte inferior del labio inferior.
underLipTop	LandmarkCoordinate	Coordenadas de la parte inferior del labio.
upperLipBottom	LandmarkCoordinate	Coordenadas de la parte inferior del labio superior.
upperLipTop	LandmarkCoordinate	Coordenadas de la parte superior del labio superior.

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 (float) minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
moustache	number (float) minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.
sideburns	number (float) minimum: 0 maximum: 1	Número comprendido entre 0 y 1 que indica un nivel de confianza asociado a una propiedad.

GlassesType

Enumeración

Gafas tipo de cara.

Valor	Description
noGlasses	No hay gafas en la cara.
readingGlasses	Gafas normales en la cara.
sunglasses	Gafas de sol en la cara.
swimmingGoggles	Gafas de natación en la cara.

HairColor

Object

Matriz de colores candidatos y nivel de confianza en presencia de cada uno.

Nombre	Tipo	Description
color	HairColorType	Nombre del color del cabello.
confidence	number (float) minimum: 0 maximum: 1	Nivel de confianza del color. Intervalo entre [0,1].

HairColorType

Enumeración

Nombre del color del cabello.

Valor	Description
black	Negro.
blond	Rubio.
brown	Marrón.
gray	Gris.
other	Otro.
red	Rojo.
unknown	Desconocido.
white	Blanco.

HairProperties

Object

Propiedades que describen atributos de cabello.

Nombre	Tipo	Description
bald	number (float) 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.

HeadPose

Object

Ángulos de giro/giro/inclinación 3D para la dirección de la cara.

Nombre	Tipo	Description
pitch	number (float)	Valor de ángulos.
roll	number (float)	Valor de ángulos.
yaw	number (float)	Valor de ángulos.

LandmarkCoordinate

Object

Coordenadas de punto de referencia dentro de una imagen.

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

MaskProperties

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 la máscara.

MaskType

Enumeración

Tipo de la máscara.

Valor	Description
faceMask	Mascarilla.
noMask	Sin máscara.
otherMaskOrOcclusion	Otros tipos de máscara o oclusión.
uncertain	Incierto.

NoiseLevel

Enumeración

Indica el nivel de ruido.

Valor	Description
high	Alto nivel de ruido.
low	Nivel de ruido bajo.
medium	Nivel de ruido medio.

NoiseProperties

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 (float) 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.

OcclusionProperties

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

Indica la calidad de la imagen para el reconocimiento.

Valor	Description
high	Alta calidad.
low	Baja calidad.
medium	Calidad media.

RecognitionModel

Enumeración

Modelo de reconocimiento para la cara.

Valor	Description
recognition_01	Modelo de reconocimiento predeterminado para "Detectar". Todos esos faceId creados antes de marzo de 2019 se unen con este modelo de reconocimiento.
recognition_02	Modelo de reconocimiento publicado en marzo de 2019.
recognition_03	Modelo de reconocimiento publicado en mayo de 2020.
recognition_04	Modelo de reconocimiento publicado en febrero de 2021. Se recomienda usar este modelo de reconocimiento para mejorar la precisión del reconocimiento.

Compartir a través de

Face Detection Operations - Detect

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

AADToken

Ámbitos

Ejemplos

Detect with Image

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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