1.3 /identity/liveness_image_verification/stateless
インターフェースを介してアップロードされた顔画像と生体認証データを比較して、画像内の顔が同一人物のものであるかどうかを判断します。
写真の規格は、運用マニュアルの3章 写真と動画の規格をご参照ください。
リクエストモード
POST
リクエスト URL
リクエストパラメーター
フィールド | 型 | 必須 | 説明 |
liveness_file | file | Yes | 生体検知SDKによる検出に成功した後に返された暗号化されたバイナリ・ストリーム・ファイル(例:protobufData)です。既に暗号化されているので、別途暗号化を必要としません |
encrypted_image | string | Yes | 暗号化された画像 。暗号化方法の参照: 個人データの暗号化 |
auto_rotate | boolean | No | デフォルト値はfalseで、画像が回転していないことを示します。値がtrueの場合、画像は自動的に回転されます |
check_quality | boolean | No | デフォルト値がfalseの場合は品質チェックを行わず、trueの場合は画像の品質チェックを行います |
通常のレスポンス
フィールド | 型 | 説明 |
code | int | システムレスポンスコード:1000 |
verification_score | float | 顔照合スコア、値0〜1、値が高いほど同一人物である可能性が高いことを示します |
request_id | string | リクエストのID |
顔比較スコアのしきい値とエラー率との対応関係
閾値 | 0.4 | 0.5 | 0.6 | 0.7 | 0.8 | 0.9 |
エラー率 | 1/10 | 1/100 | 1/1000 | 1/10,000 | 1/100,000 | 1/1,000,000 |
推奨しきい値:0.7 以上
異常なレスポンス
フィールド | 型 | 説明 |
code | int | システムレスポンスコード |
message | string | エラーメッセージ |
request_id | string | リクエストのID |
システムレスポンスコードの説明
コード | フィールドの値 | 説明 |
1200 | invalid argument | 無効な入力パラメーター |
2003 | invalid image size | 画像サイズ(幅と高さのピクセル数)が要件を満たしていません |
2004 | invalid content length | 画像のファイルサイズが要件を満たしていません |
2005 | invalid image type or corrupted | 画像タイプが要件を満たしていません |
2007 | corrupted liveness data error | 生体検知ファイルが破損しています |
4000 | detection failed | 特徴の抽出に失敗しました。画像に顔が検出されませんでした |
4004 | face occlusion | 顔は検出されていますが、目、鼻、口が部分的に見えません |
可能なHTTPステータスコード
ステータスコード | ステータスフィールド |
400 | BAD_REQUEST |
404 | NOT_FOUND |
411 | LENGTH_REQUIRED |
413 | PAYLOAD_TOO_LARGE |
500 | INTERNAL_ERROR |
使用サンプル
Curl
Java
Last updated