Face Detection Operations - Detect
Detecta caras humanas en una imagen, devuelve rectángulos de caras, opcionalmente con identificadores de cara, puntos de referencia y atributos.
Importante
Para mitigar posibles usos indebidos que pueden someter a personas a estereotipos, discriminación o denegación de servicios injustas, estamos retirando atributos de Face API que predicen emociones, sexo, edad, sonrisa, cabello facial, cabello y maquillaje. 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 de caras 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 JPEG, PNG, GIF (el primer fotograma) y el formato 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 1920 x 1080 píxeles necesitarán un tamaño de cara mínimo 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 "Identify", "Verify" y "Find Similar" ('returnFaceId' es true), usa caras que son: frontal, clara y con un tamaño mínimo de 200 x 200 píxeles (100 píxeles entre los ojos).
- Se pueden proporcionar distintos valores de "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 de Face y los puntos de referencia están deshabilitados si elige este modelo de detección.
- 'detection_03': se admiten 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 faceIds detectados se asociarán al modelo de reconocimiento especificado. Para más información, consulte https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.
POST {endpoint}/face/{apiVersion}/detect
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 |
---|---|---|---|---|
api
|
path | True |
string |
Versión de la 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). |
detection
|
query |
"detectionModel" asociado a los faceIds detectados. Los valores "detectionModel" admitidos incluyen "detection_01", "detection_02" y "detection_03". El valor predeterminado es "detection_01". |
||
face
|
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 por defecto es 86 400 (24 horas). |
|
recognition
|
query |
"recognitionModel" asociado a los faceIds detectados. Los valores "recognitionModel" admitidos 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 llevan máscaras en comparación con "recognition_03", y su precisión general se mejora en comparación con "recognition_01" y "recognition_02". |
||
return
|
query |
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 un costo adicional de cálculo y tiempo. |
||
return
|
query |
boolean |
Devuelve faceIds de las caras detectadas o no. El valor predeterminado es true. |
|
return
|
query |
boolean |
Devuelve puntos de referencia faciales de las caras detectadas o no. El valor predeterminado es false. |
|
return
|
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 imagen de entrada. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Una llamada correcta devuelve una matriz de entradas de cara clasificadas por tamaño de rectángulo de cara en orden descendente. Una respuesta vacía indica que no se han detectado caras. |
|
Other Status Codes |
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
Flow:
accessCode
Authorization URL:
https://api.example.com/oauth2/authorize
Token URL:
https://api.example.com/oauth2/token
Scopes
Nombre | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Ejemplos
Detect with Image
Sample request
POST {endpoint}/face/v1.1-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>"
Sample response
[
{
"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 |
---|---|
Accessory |
Elemento accesorio y nivel de confianza correspondiente. |
Accessory |
Tipo del accesorio. |
Blur |
Indica el nivel de desenfoque. |
Blur |
Propiedades que describen cualquier presencia de desenfoque dentro de la imagen. |
Detection |
"detectionModel" asociado a los faceIds detectados. Los valores "detectionModel" admitidos incluyen "detection_01", "detection_02" y "detection_03". El valor predeterminado es "detection_01". |
Exposure |
Indica el nivel de exposición. |
Exposure |
Propiedades que describen el nivel de exposición de la imagen. |
Face |
Atributos de cara para la cara detectada. |
Face |
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 un costo adicional de cálculo y tiempo. |
Face |
Respuesta para detectar API. |
Face |
Objeto de error. Para obtener detalles completos sobre los códigos de error y los mensajes devueltos por face Service, consulte el siguiente vínculo: https://aka.ms/face-error-codes-and-messages. |
Face |
Una respuesta que contiene los detalles del error. |
Face |
Una colección de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales. |
Face |
Rectángulo dentro del cual se puede encontrar una cara. |
Facial |
Propiedades que describen los atributos del cabello facial. |
Glasses |
Gafas tipo de cara. |
Hair |
Matriz de colores candidatos y nivel de confianza en presencia de cada uno. |
Hair |
Nombre del color del cabello. |
Hair |
Propiedades que describen los atributos del cabello. |
Head |
Ángulos de giro/giro/inclinación 3D para la dirección de la cara. |
Landmark |
Coordenadas de punto de referencia dentro de una imagen. |
Mask |
Propiedades que describen la presencia de una máscara en una cara determinada. |
Mask |
Tipo de la máscara. |
Noise |
Indica el nivel de ruido. |
Noise |
Propiedades que describen el nivel de ruido de la imagen. |
Occlusion |
Propiedades que describen oclusión en una cara determinada. |
Quality |
Indica la calidad de la imagen para el reconocimiento. |
Recognition |
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 |
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 |
Valor de enumeración que indica el nivel de desenfoque. |
|
value |
number |
Número que indica el nivel de desenfoque comprendido entre 0 y 1. |
DetectionModel
"detectionModel" asociado a los faceIds detectados. Los valores "detectionModel" admitidos 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 escenarios con caras con á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 |
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 buena exposición. [0,75, 1] supera la exposición. |
FaceAttributes
Atributos de cara para la cara detectada.
Nombre | Tipo | Description |
---|---|---|
accessories |
Propiedades que describen cualquier accesorios en una cara determinada. |
|
age |
number |
Edad en años. |
blur |
Propiedades que describen cualquier presencia de desenfoque dentro de la imagen. |
|
exposure |
Propiedades que describen el nivel de exposición de la imagen. |
|
facialHair |
Propiedades que describen los atributos del cabello facial. |
|
glasses |
Las gafas escriben si alguna de las caras. |
|
hair |
Propiedades que describen los atributos del cabello. |
|
headPose |
Ángulos de giro/giro/giro/inclinación 3D para la dirección de la cara. |
|
mask |
Propiedades que describen la presencia de una máscara en una cara determinada. |
|
noise |
Propiedades que describen el nivel de ruido de la imagen. |
|
occlusion |
Propiedades que describen oclusiones en una cara determinada. |
|
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 un costo adicional de cálculo y tiempo.
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 los atributos del cabello. |
headPose |
string |
Ángulos de giro/giro/giro/inclinación 3D para la dirección de la cara. |
mask |
string |
Si cada cara lleva 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 más ruidoso |
occlusion |
string |
Si cada área facial está ocluida, incluyendo frente, ojos y 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 calidad "alta" para la inscripción de personas y la calidad a o por encima de "media" 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 |
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 |
matriz de 27 puntos faciales de referencia de las posiciones importantes de los componentes del rostro. Para devolver esto, requiere que el parámetro "returnFaceLandmarks" sea true. |
|
faceRectangle |
Área de rectángulo para la ubicación de la cara en la imagen. |
|
recognitionModel |
El elemento "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 siguiente vínculo: 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
Una respuesta que contiene los detalles del error.
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
FaceLandmarks
Una colección de puntos de referencia faciales de 27 puntos que apuntan a las posiciones importantes de los componentes faciales.
Nombre | Tipo | Description |
---|---|---|
eyeLeftBottom |
Coordenadas de la parte inferior izquierda del ojo. |
|
eyeLeftInner |
Coordenadas del ojo izquierdo interior. |
|
eyeLeftOuter |
Coordenadas del ojo izquierdo exterior. |
|
eyeLeftTop |
Coordenadas de la parte superior izquierda. |
|
eyeRightBottom |
Coordenadas de la parte inferior derecha del ojo. |
|
eyeRightInner |
Coordenadas del ojo derecho interno. |
|
eyeRightOuter |
Coordenadas del ojo derecho exterior. |
|
eyeRightTop |
Coordenadas de la parte superior derecha del ojo. |
|
eyebrowLeftInner |
Coordenadas de la ceja izquierda interior. |
|
eyebrowLeftOuter |
Coordenadas de la ceja izquierda exterior. |
|
eyebrowRightInner |
Coordenadas de la ceja derecha interior. |
|
eyebrowRightOuter |
Coordenadas de la ceja derecha exterior. |
|
mouthLeft |
Coordenadas de la boca izquierda. |
|
mouthRight |
Coordenadas de la boca derecha. |
|
noseLeftAlarOutTip |
Coordenadas de la punta izquierda de la nariz. |
|
noseLeftAlarTop |
Coordenadas de la parte superior izquierda de la nariz. |
|
noseRightAlarOutTip |
Coordenadas de la punta derecha de la nariz. |
|
noseRightAlarTop |
Coordenadas de la parte superior derecha de la nariz. |
|
noseRootLeft |
Coordenadas de la raíz de la nariz a la izquierda. |
|
noseRootRight |
Coordenadas de la raíz de la nariz a la derecha. |
|
noseTip |
Coordenadas de la punta de la nariz. |
|
pupilLeft |
Coordenadas de la pupila del ojo izquierdo. |
|
pupilRight |
Coordenadas de la pupila del ojo derecho. |
|
underLipBottom |
Coordenadas de la parte inferior del labio inferior. |
|
underLipTop |
Coordenadas de la parte inferior del labio. |
|
upperLipBottom |
Coordenadas de la parte inferior superior del labio. |
|
upperLipTop |
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 se encuentra en el 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 |
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 |
Otros. |
red |
string |
Rojo. |
unknown |
string |
desconocida. |
white |
string |
Blanco. |
HairProperties
Propiedades que describen los atributos del cabello.
Nombre | Tipo | Description |
---|---|---|
bald |
number |
Número que describe el nivel de confianza de si la persona es balde. |
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 |
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 |
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 buena exposición. [0,75, 1] supera 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 oclusión 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 |
Calidad alta. |
low |
string |
Baja calidad. |
medium |
string |
Calidad media. |
RecognitionModel
Modelo de reconocimiento para la cara.
Nombre | Tipo | Description |
---|---|---|
recognition_01 |
string |
El 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. |