すべてのプロダクト
Search

このプロダクト

    ID Verification:FACE_COMPARE

    ドキュメントセンター

    ID Verification:FACE_COMPARE

    最終更新日:Jun 30, 2026

    サーバー側 API を通じて FaceCompareV2 を統合し、アップロードした画像内の顔を照合します。

    API の概要

    • API オペレーション：FaceCompareV2

    • リクエストメソッド：HTTPS POST

    • 説明：サーバー側の API 呼び出しで送信される画像データやその他の情報を使用して、顔を照合します。

    • QPS 制限：各 API には専用の QPS 制限があります。詳細は、「ID Verification サーバー側 API の QPS 制限」をご参照ください。

    • エンドポイント：

      説明

      • 内部ネットワークアクセスのメリット：内部ネットワークを使用すると、同じリージョン内の Alibaba Cloud サービス間でプライベートな通信が可能になります。ご利用のアプリケーションサーバーも同じリージョンにある場合は、内部ネットワークエンドポイントを使用して ID Verification サービスにアクセスすることで、より安全で安定した接続が実現します。

      • 海外アクセスの最適化：中国本土以外のネットワーク環境は複雑な場合があります。遅延を減らし、リクエストの失敗を最小限に抑えるには、「サーバー側のネットワーク遅延分析と最適化」のベストプラクティスに従って統合を最適化してください。

      シンガポール

      • パブリックエンドポイント：cloudauth-intl.ap-southeast-1.aliyuncs.com

      • 内部エンドポイント：cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

      インドネシア (ジャカルタ)

      • パブリックエンドポイント：cloudauth-intl.ap-southeast-5.aliyuncs.com

      • 内部エンドポイント：cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

      マレーシア (クアラルンプール)

      • パブリックエンドポイント：cloudauth-intl.ap-southeast-3.aliyuncs.com

      • 内部エンドポイント：cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

      中国 (香港)

      • パブリックエンドポイント：cloudauth-intl.cn-hongkong.aliyuncs.com

      • 内部エンドポイント：cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    オンラインでのデバッグと統合

    説明

    デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 API のデバッグと統合」ガイドを読み、OpenAPI プラットフォームでの API の呼び出し方法と SDK の取得方法を理解してください。

    OpenAPI Explorer を使用すると、この API を直接実行およびデバッグでき、この API の SDK コード例を生成することもできます。

    画像要件

    • サポートされる画像フォーマット：JPG、JPEG、PNG。

    • 画像サイズ：推奨 50～100 KB、最大 1 MB。

    • 画像解像度：640 x 480 ピクセル (高さ x 幅) 以上、1920 x 1080 ピクセル以下である必要があります。最適な結果を得るには、短い辺を 720 ピクセルにスケーリングし、圧縮率を 0.9 以上にすることを推奨します。横向きの画像は検出精度を低下させる可能性があるため、画像は縦向き (高さが幅より大きい) である必要があります。

      説明

      画像を base64 フォーマットに変換すると、通常データサイズが大きくなります。画像を base64 エンコードされた文字列として渡す場合、1 MB のデータ転送制限内に収まるように、元の画像が 0.6 MB 以下であることを確認してください。

    • 画質の推奨事項：

      • 顔は完全で、鮮明で、遮られていない必要があります。被写体はカメラに直接向いている必要があります。前面カメラからの画像を使用することを推奨します。

      • 顔は画像全体の 60% 以上を占める必要があります。顔が小さいと検出精度が低下する可能性があります。

      • 画像に複数の顔が含まれている場合、アルゴリズムはデフォルトで最大の顔を処理します。最良の結果を得るために、複数の顔が含まれる画像は避けてください。

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    説明

    例

    MerchantBizId

    String

    はい

    トラブルシューティングのための一意のビジネス ID。 最大 32 文字の英数字。 リクエストごとに一意である必要があります。

    e0c34a77f5ac40a5aa5e6ed20c35****

    SourceFacePicture

    String

    いいえ

    説明

    3 つのアップロード方法のいずれかを選択できます。

    ソース顔画像の Base64 エンコード文字列。

    説明

    画像サイズが指定された制限を超えないようにしてください。

    Base64 文字列

    SourceFacePictureUrl

    String

    ソース顔画像の URL。 HTTP または HTTPS 経由でパブリックにアクセスできる必要があります。

    https://***

    SourceFacePictureFile

    InputStream

    ソース顔画像のファイルストリーム。

    具体的な統合方法については、「Advance インターフェイスでのファイルアップロード」をご参照ください。

    TargetFacePicture

    String

    いいえ

    説明

    3 つのアップロード方法のいずれかを選択できます。

    ターゲット顔画像の Base64 エンコード文字列。

    説明

    画像サイズが指定された制限を超えないようにしてください。

    Base64 文字列

    TargetFacePictureUrl

    String

    ターゲット顔画像の URL。 HTTP または HTTPS 経由でパブリックにアクセスできる必要があります。

    https://***

    TargetFacePictureFile

    InputStream

    ターゲット顔画像のファイルストリーム。

    具体的な統合方法については、「Advance インターフェイスでのファイルアップロード」をご参照ください。

    FaceQualityCheck

    String

    いいえ

    顔品質検査を有効にするかどうかを指定します。 デフォルトでは無効になっています。 有効な値：

    • N：無効 (デフォルト)。

    • Y：有効。

    有効にすると、システムは低品質の写真 (不鮮明、遮蔽) の比較をブロックします。 より高い精度が必要な場合や、無効なリクエストを減らす場合に推奨します。 ブロックされた画像の場合、レスポンスの Code は UnqualifiedPhoto となります。

    N

    レスポンスパラメーター

    パラメーター

    タイプ

    説明

    例

    HTTP ステータスコード

    Integer

    HTTP ステータスコード。

    200

    HTTP ボディ

    RequestId

    String

    リクエスト ID。

    130A2C10-B9EE-4D84-88E3-5384FF0****

    Code

    String

    リターンコード：詳細については、「サーバー側の HTTP ステータスコード」をご参照ください。

    Success

    Message

    String

    レスポンスコードの詳細な説明。

    success

    Result.TransactionId

    String

    認証リクエストの一意の ID。

    08573be80f944d95ac812e019e36****

    Result.Passed

    String

    最終的な認証結果。 有効な値：

    • Y：合格

    • N：不合格

    Y

    Result.FaceComparisonScore

    String

    顔照合スコア。範囲は 0～100 です。

    52.57