すべてのプロダクト
Search

このプロダクト

    ID Verification:FACE_CROSS_COMPARE

    ドキュメントセンター

    ID Verification:FACE_CROSS_COMPARE

    最終更新日:Feb 27, 2026

    このトピックでは、サーバーサイド API のみを使用して FACE_CROSS_COMPARE サービスを統合する方法について説明します。このサービスを使用すると、入力された 3 つの顔画像が同一人物のものであるかどうかを検証できます。

    API の説明

    • 操作名： FaceCrossCompareIntl

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

    • 説明： この操作は、入力された 3 つの顔画像が同一人物のものであるかどうかを検証します。

    • この API 操作には専用の QPS 制限があります。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。

    • サービスエンドポイント：

      説明

      • 内部ネットワークアクセスの利点： 内部ネットワークは、同一リージョン内の Alibaba Cloud プロダクト間のプライベートな通信ネットワークです。ビジネスサーバーが対応する 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.cn-hongkong.aliyuncs.com

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

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

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

    説明

    API 操作をデバッグおよび統合する前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」で、API 操作の呼び出し方法、および OpenAPI Explorer で SDK とサンプルコードを取得する方法をご確認ください。

    OpenAPI Explorer では、この API 操作を実行してデバッグし、SDK コード例を生成できます。

    入力画像のフォーマット要件

    • 画像フォーマット： JPG、JPEG、または PNG。

    • 画像サイズ： 50 KB から 100 KB を推奨します。最大サイズは 1 MB です。

    • 画像解像度： 解像度は 640 × 480 ピクセル (高さ × 幅) から 1920 × 1080 ピクセルの範囲である必要があります。短い辺を 720 ピクセルにスケーリングし、圧縮率を 0.9 以上にすることを推奨します。画像の高さは幅よりも大きくする必要があります。幅が高さよりも大きい場合、検出精度が低下する可能性があります。

      説明

      画像を Base64 フォーマットに変換すると、データサイズが増加します。Base64 フォーマットでパラメーターを渡すには、1 MB のデータ転送制限を超えないように、元の画像サイズが 0.6 MB を超えないようにしてください。

    • 画像品質の推奨事項：

      • 画像内の顔は、完全で、鮮明で、遮られていない必要があります。被写体はカメラにまっすぐ向いている必要があります。前面カメラで撮影した顔画像の使用を推奨します。

      • 顔は画像領域の 60% 以上を占めるようにしてください。顔が小さいと、検出精度が低下する可能性があります。

      • 画像に複数の顔がある場合、アルゴリズムはデフォルトで最大の顔を切り取ります。複数の顔がある画像は避けることを推奨します。

    リクエストパラメーター

    説明

    画像データは、以下のいずれかの方法で提供してください：

    • SourceFacePicture を使用して、Base64 エンコードされた画像をアップロードします。

    • SourceFacePictureUrl を使用して、画像 URL を提供します。

    どちらか一方の方法のみを選択してください。Base64 を使用する場合、大きな画像は避けてください。

    名前

    型

    必須

    説明

    例

    ProductCode

    String

    はい

    統合するプロダクトソリューション。FACE_CROSS_COMPARE に設定します。

    FACE_CROSS_COMPARE

    SceneCode

    String

    いいえ

    カスタムのビジネスシナリオ ID。

    1234567890

    MerchantBizId

    String

    はい

    トラブルシューティングに使用されるカスタムの一意なビジネス識別子。長さは 32 文字で、英数字のみを含む必要があります。一意性を確保してください。

    e0c34a77f5ac40a5aa5e6ed20c35****

    CompareModel

    String

    いいえ

    比較モード：

    • 0 — チェーン比較 (デフォルト)： A と B を比較し、次に B と C を比較します。

    • 1 — ループ比較： A と B、B と C、C と A を比較します。

    0

    SourceAFacePicture

    String

    いいえ

    Base64 エンコードされた顔画像。

    base64

    SourceAFacePictureUrl

    String

    いいえ

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

    https://www.xxx.com/1.jpg

    SourceBFacePicture

    String

    いいえ

    Base64 エンコードされた顔画像。

    base64

    SourceBFacePictureUrl

    String

    いいえ

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

    https://www.xxx.com/1.jpg

    SourceCFacePicture

    String

    いいえ

    Base64 エンコードされた顔画像。

    base64

    SourceCFacePictureUrl

    String

    いいえ

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

    https://www.xxx.com/1.jpg

    FaceVerifyThreshold

    String

    いいえ

    顔照合のしきい値。これは予約済みのシステムパラメーターです。カスタム値はサポートされていません。

    0.4

    レスポンスデータ

    名前

    型

    説明

    値の例

    HTTP ステータスコード

    Integer

    HTTP ステータスコード。

    200

    HTTP ボディ

    RequestId

    String

    リクエストの一意の ID。

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

    Message

    String

    コードの詳細な説明を返します。

    success

    Code

    String

    レスポンスコード。

    Success

    Result.FacePassed

    String

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

    • Y： 成功

    • N： 失敗

    Y

    FaceComparisonScoreA2B

    number<double>

    A と B の比較スコア。範囲： 0～1。

    0.9

    FaceComparisonScoreC2A

    number<double>

    C と A の比較スコア。範囲： 0～1。

    0.9

    FaceComparisonScoreB2C

    number<double>

    B と C の比較スコア。範囲： 0～1。

    0.9

    Result.TransactionId

    String

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

    08573be80f944d95ac812e019e36****

    レスポンスコード

    HTTP ステータスコード

    コード

    説明

    200

    Success

    リクエストは成功しました。

    400

    MissingParameter

    パラメーターを空にすることはできません。

    400

    InvalidParameter

    パラメーターが無効です。

    401

    NoFaceDetected

    カスタムソース画像の顔の特徴抽出に失敗しました。別の画像をアップロードしてください。

    401

    UnqualifiedPhoto

    アップロードされた画像が読み取れないか、解像度が要件を満たしていません。画像を置き換えてください。写真が鮮明で、露出が適切で、完全で、遮られておらず、被写体の頭に大きな傾きがないことを確認してください。

    401

    ToolargeImage

    画像が大きすぎます。画像を圧縮するか、別のアップロード方法を使用してください。

    401

    DataDuplication

    Base64 と URL の両方のメソッドで同時に画像を渡しました。

    401

    DownloadTimeout

    URL からの画像のダウンロードがタイムアウトしました。

    403

    Forbidden.RAMUserAccessDenied

    RAM ユーザーに AliyunAntCloudAuthFullAccess 権限を付与してください。詳細については、「RAM ユーザーへのサービスアクセス権限の付与」をご参照ください。

    403

    Forbidden.AccountAccessDenied

    ID Verification を有効化し、アカウントに支払い遅延がないことを確認してください。

    403

    Throttling.Api

    API 呼び出しが速度制限によってブロックされています。

    500

    InternalError

    内部システムエラーが発生しました。テクニカルサポートにお問い合わせください。