このトピックでは、サーバーサイド API 操作のみを使用して顔照合機能を統合する方法について説明します。
API の説明
API 操作： FaceCompare
リクエストメソッド： HTTPS POST
説明： この API 操作は、サーバーサイド API 呼び出しで渡された画像データやその他の情報を使用して顔照合を実行します。
この API 操作には専用の QPS 制限があります。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。
エンドポイント：
説明内部ネットワークアクセスのメリット： 内部ネットワークは、同一リージョン内の Alibaba Cloud プロダクト間のプライベートな通信ネットワークです。ビジネスサーバーが対応する Alibaba Cloud リージョンにデプロイされている場合、内部の同一リージョンエンドポイントを使用して ID Verification サービスにアクセスできます。これにより、より安全で安定した通信が提供されます。
中国以外からのアクセスの最適化に関する提案： 中国以外のネットワーク環境は複雑になる可能性があります。統合ソリューションを最適化し、ネットワーク遅延を削減し、リクエストの失敗を最小限に抑えるには、「サーバーサイドのネットワーク遅延分析と最適化」をご参照ください。
中国 (香港)
パブリックネットワーク：
cloudauth-intl.cn-hongkong.aliyuncs.com内部ネットワーク：
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
インドネシア
パブリックネットワーク：
cloudauth-intl.ap-southeast-5.aliyuncs.com内部ネットワーク：
cloudauth-intl-vpc.ap-southeast-5.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% 以上を占めるようにしてください。顔が小さいと、検出精度が低下する可能性があります。
画像に複数の顔がある場合、アルゴリズムはデフォルトで最大の顔を切り抜きます。複数の顔がある画像は避けることを推奨します。
リクエストパラメーター
名前 | 型 | 必須 | 説明 | 例 |
MerchantBizId | String | はい | トラブルシューティングに使用されるカスタムの一意のビジネス ID。最大 32 文字の英数字の組み合わせが可能です。ID が一意であることを確認してください。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
SourceFacePicture | String | はい | ポートレート写真の Base64 エンコーディング。 説明 このメソッドを使用して画像を渡す場合は、画像サイズを確認してください。大きすぎる画像を渡さないでください。 | Base64 エンコーディング |
SourceFacePictureUrl | String | いいえ | ポートレート写真の URL。URL は、インターネット経由でアクセス可能な HTTP または HTTPS リンクである必要があります。 説明 SourceFacePicture または SourceFacePictureUrl のいずれかを指定する必要があります。 | https://*** |
TargetFacePicture | String | いいえ | ベース写真の Base64 エンコーディング。 説明 このメソッドを使用して画像を渡す場合は、画像サイズを確認してください。大きすぎる画像を渡さないでください。 | Base64 エンコーディング |
TargetFacePictureUrl | String | いいえ | ベースのポートレート写真の URL。URL は、インターネット経由でアクセス可能な HTTP または HTTPS リンクである必要があります。 説明 TargetFacePicture または TargetFacePictureUrl のいずれかを指定する必要があります。 | https://*** |
戻りデータ
名前 | 型 | 説明 | 値の例 | |
HTTP ステータスコード | Integer | HTTP ステータスコード。 | 200 | |
HTTP ボディ | RequestId | String | リクエスト ID。 | 130A2C10-B9EE-4D84-88E3-5384FF0**** |
Code | String | Success | ||
Message | String | 応答コードの詳細な説明。 | success | |
Result.TransactionId | String | 認証リクエストの一意の ID。 | 08573be80f944d95ac812e019e36**** | |
Result.Passed | String | 最終的な認証結果。有効な値：
| Y | |
Result.FaceComparisonScore | String | 顔照合スコア。値の範囲は 0 から 100 です。 | 52.57 | |
リターンコード
HTTP ステータスコード | コード | 説明 |
200 | Success | リクエストは成功しました。 |
400 | MissingParameter | パラメーターを空にすることはできません。 |
400 | InvalidParameter | パラメーターが無効です。 |
401 | NoFaceDetected | カスタムソース画像の顔の特徴抽出に失敗しました。別の画像をアップロードしてください。 |
401 | UnqualifiedPhoto | アップロードされた画像が読み取り不可であるか、解像度が要件を満たしていません。画像を置き換えてください。写真が鮮明で、適切な露出で、完全で、遮られておらず、被写体の頭に大きな傾きがないことを確認してください。 |
401 | ToolargeImage | 画像が大きすぎます。画像を圧縮するか、別のアップロード方法を使用してください。 |
401 | DataDuplication | また、 Base64 またはリンクを使用してイメージを渡すこともできます。 |
401 | DownloadTimeout | URL からの画像のダウンロードがタイムアウトしました。 |
403 | Forbidden.RAMUserAccessDenied | Resource Access Management (RAM) ユーザーに AliyunAntCloudAuthFullAccess 権限を付与してください。詳細については、「RAM ユーザーへのサービスアクセス権限の付与」をご参照ください。 |
403 | Forbidden.AccountAccessDenied | ID Verification を有効化し、アカウントに支払い遅延がないことを確認してください。 |
403 | Throttling.Api | API 呼び出しがスロットリングによってブロックされました。 |
500 | InternalError | 内部システムエラーが発生しました。テクニカルサポートに連絡して支援を求めてください。 |