---
title: "顔分析"
url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/face-analytics/
description: "このページでは、サンプルコードスニペットを使用して、PythonアプリケーションでFace Analytics機能を使用して指定された条件で顔を検出する方法について説明します。"
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: general
related_links:
  - name: "Face Analytics - API"
    url: /ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics
  - name: "SDK Scopes"
    url: /ja/sdk/python/v1/sdk-scopes
---

# Face Analytics

[Zia Face Analytics](https://docs.catalyst.zoho.com/ja/zia-services/help/face-analytics/introduction)は、画像内の顔検出を実行し、顔の特徴を分析して、検出された顔の性別、年齢、感情などの情報を提供します。

Face Analyticsを実行するために、.webp/.jpegまたは.pngファイルを`open()`メソッドへの入力として提供する必要があります。これにより、指定されたファイルが開かれ、レスポンスとしてファイルオブジェクトが返されます。

`analyse_face()`メソッドは、入力画像を引数として受け取ります。分析モードを`basic`、`moderate`、または`advanced`として指定することもできます。また、属性`age`、`smile`、または`gender`を検出する場合は`true`、検出しない場合は`false`として指定できます。これらの値はオプションです。デフォルトでは、すべての属性が検出され、`advanced`モードが処理されます。

リクエストとレスポンスの形式については、[APIドキュメント](https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/face-analytics/#FaceAnalytics)を参照してください。

以下で使用されているコンポーネントインスタンス`zia`の詳細については、[こちらのヘルプセクション](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/get-component-instance/)を参照してください。

レスポンスは、有効化された属性の予測、各顔の顔の特徴の座標とランドマーク、および各分析の信頼度スコアを返します。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
         <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
    <tr>
		<td>`img`</td>
      <td>Image</td>
			<td>**必須**パラメータです。分析対象の顔の画像を格納します。</td>
		</tr>
    <tr>
		<td>`mode`</td>
      <td>String</td>
			<td>**オプション**パラメータです。分析モードの値（「basic」、「moderate」、または「advanced」）を格納します。</td>
	 </tr>
      <tr>
		<td>`age`</td>
      <td>Boolean</td>
			<td>**オプション**パラメータです。年齢を判定するかどうかを決定します。「Yes」または「No」の値を受け付けます。</td>
		</tr>
         <tr>
		<td>`emotion`</td>
      <td>Boolean</td>
			<td>**オプション**パラメータです。感情を判定するかどうかを決定します。「Yes」または「No」の値を受け付けます。</td>
		</tr>
      <tr>
		<td>`gender`</td>
      <td>Boolean</td>
			<td>**オプション**パラメータです。性別を判定するかどうかを決定します。「True」または「False」の値を受け付けます。</td>
		</tr>
	</tbody>
</table>

```python
# Face Analytics implementation
zia = app.zia()
img = open("sample.webp", "rb")
result = zia.analyse_face(
    img, {"mode": "moderate", "age": True, "emotion": True, "gender": False}
)

```

サンプルレスポンスを以下に示します：

```json
{
   "faces_count":1,
   "faces":[
      {
         "co_ordinates":[
            "401",
            "193",
            "494",
            "313"
         ],
         "emotion":{
            "confidence":{
               "smiling":"0.75",
               "not_smiling":"0.25"
            },
            "prediction":"smiling"
         },
         "gender":{
            
         },
         "confidence":1,
         "id":"0",
         "landmarks":{
            "right_eye":[
               [
                  "467",
                  "230"
               ]
            ],
            "nose":[
               [
                  "451",
                  "264"
               ]
            ],
            "mouth_right":[
               [
                  "474",
                  "278"
               ]
            ],
            "left_eye":[
               [
                  "426",
                  "239"
               ]
            ],
            "mouth_left":[
               [
                  "434",
                  "283"
               ]
            ]
         },
         "age":{
            "confidence":{
               "20-29":"0.73",
               "30-39":"0.08",
               "0-2":"0.0",
               "40-49":"0.0",
               "50-59":"0.0",
               ">70":"0.0",
               "60-69":"0.0",
               "10-19":"0.17",
               "3-9":"0.0"
            },
            "prediction":"20-29"
         }
      }
   ]
}

```

> **情報 :** 上記の操作を実行するために必要な権限レベルを確認するには、[SDKスコープテーブル](https://docs.catalyst.zoho.com/ja/sdk/python/v1/sdk-scopes)を参照してください。