Face Analytics
Zia Face Analyticsは、画像内の顔検出を実行し、顔の特徴を分析して、検出された顔の性別、年齢、感情などの情報を提供します。
Face Analyticsは、各属性予測の信頼度レベルも提供し、情報に基づいた意思決定を可能にします。画像内で最大10個の顔を検出でき、検出された各顔の属性予測を提供します。
Face Analyticsの実行
説明
このAPIを使用して、画像ファイル内の顔検出と分析を実行し、サンプルリクエストに示すようにAPIリクエストでそのパスを指定できます。
オプションで、顔内で検出される顔のランドマーク数を決定する分析モードを指定できます。また、感情、年齢、性別など、予測する属性の有効・無効を設定することもできます。
このAPIは、Face Analytics予測の入力を渡すために使用されます。以下に説明するように、リクエストで入力画像ファイルとJSON形式のデータを渡す必要があります。
リクエスト詳細
リクエストURL
{api-domain}/baas/v1/project/{project_id}/ml/faceanalytics
リクエストヘッダー
Authorization: Zoho-oauthtoken {oauth_token}
content-type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW
オプションヘッダー
CATALYST-ORG: {org_id}
Environment: Development
スコープ
ZohoCatalyst.mlkit.READ
リクエストJSONプロパティ
処理する入力ファイル。ローカルシステム内のパスを指定する必要があります。
許可される形式: .webp, .jpeg, .png
ファイルサイズ制限: 10 MB
顔内で検出される顔のランドマーク数を示します
許可される値: basic, moderate, advanced
デフォルト値: advanced
- basic: 顔の境界のみを検出する0ポイントランドマーク検出器
- moderate: 以下を検出する5ポイントランドマーク検出器 - 目: 両目の中心、鼻: 鼻先、唇: 両唇の中心
- advanced: 以下を検出する68ポイントランドマーク検出器 - 顎のライン: 顔の境界、眉: 左右の眉、目: 左右の目、鼻筋、鼻孔ライン、上唇: 上端と下端、下唇: 上端と下端
許可される値:
false: 感情は検出されません
true: 感情が検出されます
デフォルト値: true
許可される値:
false: 年齢は検出されません
true: 年齢が検出されます
デフォルト値: true
許可される値:
false: 性別は検出されません
true: 性別が検出されます
デフォルト値: true
レスポンス詳細
レスポンスは、検出された顔の顔ランドマークの詳細、およびAPIリクエストで設定されたパラメータとモードに基づく感情、年齢、性別の予測をdataキーで返します。
顔ランドマーク検出の座標の全体的な確率、および感情、年齢、性別パラメータの予測の確率は、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