Face Detection Operations - Detect

Referencia

Servicio:: Azure AI Services

Versión de la API:: v1.2-preview.1

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. Envíe un correo electrónico a Azure Face API azureface@microsoft.com 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 https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- 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'. Para usar y comparar diferentes modelos de detección, consulte https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
  - 'detection_02': los atributos y los puntos de referencia de Face están deshabilitados si elige este modelo de detección.
  - 'detection_03': se admiten los atributos face (máscara, desenfoque y headPose) y puntos de referencia si elige este 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 https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

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".
faceIdTimeToLive	query		integer int32	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	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-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>"

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

Elemento accesorio y nivel de confianza correspondiente.

Nombre	Tipo	Description
confidence	number	Nivel de confianza del tipo de accesorio. Intervalo entre [0,1].
type	AccessoryType	Tipo del accesorio.

AccessoryType

Tipo del accesorio.

Nombre	Tipo	Description
glasses	string	Gafas.
headwear	string	Desgaste de la cabeza.
mask	string	Máscara.

BlurLevel

Indica el nivel de desenfoque.

Nombre	Tipo	Description
high	string	Alto nivel de desenfoque.
low	string	Nivel de desenfoque bajo.
medium	string	Nivel de desenfoque medio.

BlurProperties

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	Número que indica el nivel de desenfoque que va de 0 a 1.

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

Nombre	Tipo	Description
detection_01	string	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	string	Modelo de detección publicado en mayo de 2019 con una precisión mejorada especialmente en caras pequeñas, laterales y borrosas.
detection_03	string	Modelo de detección publicado en febrero de 2021 con una precisión mejorada especialmente en caras pequeñas.

ExposureLevel

Indica el nivel de exposición.

Nombre	Tipo	Description
goodExposure	string	Buen nivel de exposición.
overExposure	string	Alto nivel de exposición.
underExposure	string	Nivel de exposición bajo.

ExposureProperties

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

Atributos de cara para la cara detectada.

Nombre	Tipo	Description
accessories	AccessoryItem[]	Propiedades que describen cualquier accesorios en una cara determinada.
age	number	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	Intensidad de la sonrisa, un número entre [0,1].

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.

Nombre	Tipo	Description
accessories	string	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	string	Edad en años.
blur	string	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	string	Nivel de exposición facial. Level devuelve "GoodExposure", "OverExposure" o "UnderExposure".
facialHair	string	Propiedades que describen los atributos del cabello facial.
glasses	string	Tipo de gafas. Los valores incluyen "NoGlasses", "ReadingGlasses", "Gafas de sol", "SwimmingGoggles".
hair	string	Propiedades que describen atributos de cabello.
headPose	string	Ángulos de giro/giro/inclinación 3D para la dirección de la cara.
mask	string	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	string	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	string	Si cada área facial está ocluida, incluyendo la frente, los ojos y la boca.
qualityForRecognition	string	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	string	Intensidad de la sonrisa, un número entre [0,1].

FaceDetectionResult

Respuesta para detectar api.

Nombre	Tipo	Description
faceAttributes	FaceAttributes	Atributos de cara para la cara detectada.
faceId	string	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

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

Respuesta que contiene los detalles del error.

Nombre	Tipo	Description
error	FaceError	Objeto de error.

FaceLandmarks

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

Rectángulo dentro del cual se puede encontrar una cara.

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

FacialHair

Propiedades que describen los atributos del cabello facial.

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

GlassesType

Gafas tipo de cara.

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

HairColor

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	Nivel de confianza del color. Intervalo entre [0,1].

HairColorType

Nombre del color del cabello.

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

HairProperties

Propiedades que describen atributos de cabello.

Nombre	Tipo	Description
bald	number	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

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

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

LandmarkCoordinate

Coordenadas de punto de referencia dentro de una imagen.

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

MaskProperties

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

Tipo de la máscara.

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

NoiseLevel

Indica el nivel de ruido.

Nombre	Tipo	Description
high	string	Alto nivel de ruido.
low	string	Nivel de ruido bajo.
medium	string	Nivel de ruido medio.

NoiseProperties

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

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

Indica la calidad de la imagen para el reconocimiento.

Nombre	Tipo	Description
high	string	Alta calidad.
low	string	Baja calidad.
medium	string	Calidad media.

RecognitionModel

Modelo de reconocimiento para la cara.

Nombre	Tipo	Description
recognition_01	string	Modelo de reconocimiento predeterminado para "Detectar". Todos esos faceId creados antes de marzo de 2019 se unen con este modelo de reconocimiento.
recognition_02	string	Modelo de reconocimiento publicado en marzo de 2019.
recognition_03	string	Modelo de reconocimiento publicado en mayo de 2020.
recognition_04	string	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

Recursos adicionales