Ask me anything
How can I help you with Catalyst today?
Face Analytics
Zia Face Analytics realiza detección facial en imágenes y analiza las características faciales para proporcionar información como el género, la edad y la emoción de los rostros detectados.
Face Analytics también proporciona los niveles de confianza de cada predicción de atributo que te permiten tomar decisiones informadas. Puede detectar hasta 10 rostros en una imagen y proporciona predicciones de los atributos para cada rostro detectado.
Ejecutar Face Analytics
Descripción
Puedes usar esta API para realizar detección y análisis facial en un archivo de imagen, y especificar la ruta al archivo en la solicitud de la API como se muestra en la solicitud de ejemplo.
Opcionalmente puedes especificar un modo de análisis que determina la cantidad de puntos de referencia faciales a detectar en un rostro. También puedes habilitar o deshabilitar los atributos a predecir, como la emoción, la edad y el género.
Esta API se usa para pasar datos de entrada para la predicción de Face Analytics. Debes pasar un archivo de imagen de entrada y los datos en formato JSON en la solicitud como se describe a continuación.
Detalles de la Solicitud
URL de Solicitud
{api-domain}/baas/v1/project/{project_id}/ml/faceanalytics
Encabezados de Solicitud
Authorization: Zoho-oauthtoken {oauth_token}
content-type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW
Encabezados Opcionales
CATALYST-ORG: {org_id}
Environment: Development
Alcance
ZohoCatalyst.mlkit.READ
Propiedades del JSON de Solicitud
El archivo de entrada a procesar. Debes proporcionar la ruta en tu sistema local.
Formatos permitidos: .webp, .jpeg, .png
Límite de tamaño de archivo: 10 MB
Indica la cantidad de puntos de referencia faciales a detectar en un rostro
Valores permitidos: basic, moderate, advanced
Valor predeterminado: advanced
- basic: Detector de 0 puntos de referencia que detecta solo el contorno del rostro
- moderate: Detector de 5 puntos de referencia que detecta- Ojos: El centro de ambos ojos, Nariz: Punta de la nariz, Labios: El centro de ambos labios
- advanced: Detector de 68 puntos de referencia que detecta- Línea de mandíbula: Contorno del rostro, Cejas: Ceja izquierda y derecha, Ojos: Ojo izquierdo y derecho, Puente nasal, Línea de fosas nasales, Labio superior: Borde superior e inferior, Labio inferior: Borde superior e inferior
Valores permitidos:
false: La emoción no será detectada
true: La emoción será detectada
Valor predeterminado: true
Valores permitidos:
false: La edad no será detectada
true: La edad será detectada
Valor predeterminado: true
Valores permitidos:
false: El género no será detectado
true: El género será detectado
Valor predeterminado: true
Detalles de la Respuesta
La respuesta devuelve los detalles de los puntos de referencia faciales de los rostros detectados, y las predicciones de emoción, edad y género, basadas en los parámetros y modo establecidos en la solicitud de la API en la clave data.
La probabilidad general de las coordenadas de la detección de puntos de referencia faciales, y la probabilidad de las predicciones realizadas para los parámetros de emoción, edad y género se devolverán como puntuaciones de confidence.
curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW”
-F “file=@attachment1.txt”
-d ‘{
“mode”: “basic”,
“emotion”: “true”,
“age”: “true”,
“gender”: “true”
}’
{
"status": "success",
"data": {
"faces": [
{
"confidence": 1.0,
"id": 0,
"co_ordinates": [
267,
39,
153,
227
],
"emotion": {
"prediction": "not_smiling",
"confidence": {
"smiling": "0.0",
"not_smiling": "1.0"
}
},
"age": {
"prediction": "3-9",
"confidence": {
"0-2": "0.005",
"10-19": "0.33",
"20-29": "0.12",
"3-9": "0.509",
"30-39": "0.032",
"40-49": "0.003",
"50-59": "0.0",
"60-69": "0.0",
">70": "0.0"
}
},
"gender": {
"prediction": "female",
"confidence": {
"female": "0.92",
"male": "0.08"
}
}
}
]
}
}
curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW”
-F “file=@attachment1.txt”
-d ‘{
“mode”: “moderate”,
“emotion”: “false”,
“age”: “false”,
“gender”: “true”
}’
{
"status": "success",
"data": {
"faces": [
{
"confidence": 1.0,
"id": 0,
"co_ordinates": [
267,
39,
153,
227
],
"landmarks": {
"left_eye": [337,135],
"right_eye": [400,130],
"nose": [
400,
165
],
"mouth_left": [
353,
217
],
"mouth_right": [
404,
211
]
},
"gender": {
"prediction": "female",
"confidence": {
"female": "0.92",
"male": "0.08"
}
}
}
]
}
}
curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW”
-F “file=@attachment1.txt”
-d ‘{
“mode”: “advanced”,
“emotion”: “true”,
“age”: “false”,
“gender”: “false”
}’
{
"status": "success",
"data": {
"faces": [
{
"co_ordinates" : [ 185, 96, 275, 18],
"confidence" : 0.99
"landmarks" : {
'mouth': [
[259, 440],
[287, 423],
[312, 413],
[325, 418],
[338, 414],
[354, 424],
[368, 442],
[355, 461],
[339, 470],
[325, 472],
[310, 470],
[285, 460],
[269, 440],
[311, 435],
[324, 436],
[338, 436],
[359, 442],
[339, 440],
[326, 441],
[312, 439]
],
'right_eyebrow': [
[189, 245],
[216, 230],
[244, 227],
[273, 234],
[301, 248]
],
'left_eyebrow': [
[356, 249],
[379, 238],
[401, 232],
[422, 235],
[436, 252]
],
'right_eye': [
[225, 288],
[245, 281],
[265, 282],
[280, 295],
[263, 297],
[244, 297]
],
'left_eye': [
[358, 299],
[376, 288],
[393, 290],
[408, 298],
[393, 305],
[376, 304]
],
'nose': [
[329, 287],
[331, 311],
[334, 336],
[337, 360],
[301, 385],
[315, 389],
[329, 392],
[341, 390],
[352, 385]
],
'jaw': [
[131, 283],
[136, 340],
[145, 393],
[158, 442],
[180, 484],
[212, 513],
[250, 530],
[287, 542],
[319, 545],
[347, 535],
[370, 512],
[393, 487],
[411, 456],
[423, 419],
[432, 381],
[437, 342],
[439, 303]
]
},
"emotion": {
"prediction": "not_smiling",
"confidence": {
"smiling": "0.0",
"not_smiling": "1.0"
}
}
}
]
}
}
Yes
No
Thank you for your feedback!
Send your feedback to us