---
title: "顔の比較"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/identity-scanner/facial-comparison/
description: "このAPIを使用すると、2つの異なる画像の2つの顔を比較して、同一人物であるかどうかを判定できます。"
last_updated: 2026-03-30T08:10:30Z
service: Zia Services
type: api
---

# Identity Scanner

[Identity Scanner](https://docs.catalyst.zoho.com/ja/zia-services/help/identity-scanner/introduction/)は、Zia AIを活用したコンポーネントで、さまざまな身分証明書や公式文書をスキャン・処理することにより、個人や文書に対する安全な本人確認を実行できます。E-KYCとDocument Processingの2つの主要カテゴリに分かれた複数の機能を組み込んだ包括的なスイートです。

> **注意:** Catalystは、アップロードされたファイルをシステムに保存しません。アップロードされた文書は一回限りの処理にのみ使用されます。MLモデルのトレーニング目的にも使用されません。Catalystコンポーネントは、適用されるすべてのデータ保護およびプライバシー法に完全に準拠しています。

# Facial Comparison

[Facial Comparison](https://docs.catalyst.zoho.com/ja/zia-services/help/identity-scanner/key-concepts/#e-kyc)（E-KYCとも呼ばれる）は、Identity Scannerの一部で、2つの異なる画像の2つの顔を比較して、同一人物であるかどうかを判定します。

> **注意:** Identity ScannerのDocument Processing機能はインドのユーザーのみに関連しますが、Facial Comparison APIおよびSDKツールはグローバルなユーザーが利用できます。ただし、CatalystコンソールからのFacial ComparisonまたはE-KYCへのアクセスとテストは、IN DCのユーザーのみに制限されています。

## Facial Comparisonの処理

### 説明

このAPIを使用すると、ソース画像とクエリ画像の間で顔比較を実行できます。サンプルリクエストに示すように、APIリクエストで両方の画像ファイルのパスを指定する必要があります。

> **注意:** 身分証明書の画像または個人の写真のいずれかをソースまたはクエリ画像として指定できます。これは結果に影響しません。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/ml/facecomparison

- **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プロパティ

- **source_image** (file, mandatory):  写真付き身分証明書または個人の写真。ローカルシステム内のパスを指定する必要があります。

許可される形式: *.webp, .jpeg, .png*

ファイルサイズ制限: 10 MB

- **query_image** (file, mandatory):  写真付き身分証明書または個人の写真。ローカルシステム内のパスを指定する必要があります。

許可される形式: *.webp, .jpeg, .png*

ファイルサイズ制限: 10 MB

### レスポンス詳細

レスポンスは、顔が一致した場合は`true`、一致しなかった場合は`false`として比較結果を返します。

レスポンスには、0から1の範囲の信頼度スコアも含まれます。比較で50%（0.5）を超える信頼度スコアが得られた場合にのみ、結果は`true`に設定されます。

**リクエスト例**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/facecomparison \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \
-F source_image=/Desktop/SourceImage.webp \
-F query_image=/Desktop/QueryImage.webp

```

**レスポンス例**

```json

    {
        "status": "success",
        "data": {
            "confidence": 1.0,
            "matched": "true"
        }
    }
```

### SDK Documentation

[Facial Comparison- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/identity-scanner/facial-comparison)

[Facial Comparison- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/identity-scanner/facial-comparison)

[Facial Comparison- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/identity-scanner/facial-comparison)