--- title: "顔分析" url: https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/face-analytics/ description: "このAPIを使用すると、画像ファイル内の顔検出と分析を実行し、検出された顔の性別、年齢、感情の予測を取得できます。" last_updated: 2026-06-09T07:46:16Z service: Zia Services type: api --- # Face Analytics [Zia Face Analytics](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/introduction/)は、画像内の顔検出を実行し、顔の特徴を分析して、検出された顔の性別、年齢、感情などの情報を提供します。 Face Analyticsは、各属性予測の信頼度レベルも提供し、情報に基づいた意思決定を可能にします。画像内で最大10個の顔を検出でき、検出された各顔の属性予測を提供します。 # Face Analyticsの実行 ### 説明 このAPIを使用して、画像ファイル内の顔検出と分析を実行し、サンプルリクエストに示すようにAPIリクエストでそのパスを指定できます。 オプションで、顔内で検出される顔のランドマーク数を決定する分析モードを指定できます。また、感情、年齢、性別など、予測する属性の有効・無効を設定することもできます。 このAPIは、Face Analytics予測の入力を渡すために使用されます。以下に説明するように、リクエストで入力画像ファイルとJSON形式のデータを渡す必要があります。 ### リクエスト詳細 #### リクエストURL `POST` {api-domain}/baas/v1/project/{project_id}/ml/faceanalytics - **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン - **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/) #### リクエストヘッダー **Authorization:** Zoho-oauthtoken {oauth_token} **content-type:** multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW **オプションヘッダー** **CATALYST-ORG:** {org_id} **Environment:** Development #### スコープ ZohoCatalyst.mlkit.READ #### リクエストJSONプロパティ - **file** (file, mandatory): 処理する入力ファイル。ローカルシステム内のパスを指定する必要があります。 許可される形式: *.webp, .jpeg, .png* ファイルサイズ制限: 10 MB - **mode** (string, optional): 顔内で検出される顔のランドマーク数を示します 許可される値: `basic`, `moderate`, `advanced` デフォルト値: `advanced` * `basic`: 顔の境界のみを検出する0ポイントランドマーク検出器 * `moderate`: 以下を検出する5ポイントランドマーク検出器 - 目: 両目の中心、鼻: 鼻先、唇: 両唇の中心 * `advanced`: 以下を検出する68ポイントランドマーク検出器 - 顎のライン: 顔の境界、眉: 左右の眉、目: 左右の目、鼻筋、鼻孔ライン、上唇: 上端と下端、下唇: 上端と下端 - **emotion** (boolean, optional): 許可される値: `false`: 感情は検出されません `true`: 感情が検出されます デフォルト値: `true` - **age** (boolean, optional): 許可される値: `false`: 年齢は検出されません `true`: 年齢が検出されます デフォルト値: `true` - **gender** (boolean, optional): 許可される値: `false`: 性別は検出されません `true`: 性別が検出されます デフォルト値: `true` ### レスポンス詳細 レスポンスは、検出された顔の顔ランドマークの詳細、およびAPIリクエストで設定されたパラメータとモードに基づく感情、年齢、性別の予測を`data`キーで返します。 顔ランドマーク検出の座標の全体的な確率、および感情、年齢、性別パラメータの予測の確率は、`confidence`スコアとして返されます。 **リクエスト例：Basic** ```bash 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" }' ``` **レスポンス例：Basic** ```json { "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" } } } ] } } ``` **リクエスト例：Moderate** ```bash 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" }' ``` **レスポンス例：Moderate** ```json { "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" } } } ] } } ``` **リクエスト例：Advanced** ```bash 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" }' ``` **レスポンス例：Advanced** ```json { "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" } } } ] } } ``` ### SDK Documentation [Face Analytics- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/face-analytics)

[Face Analytics- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/face-analytics)

[Face Analytics- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/face-analytics)