1.3 /identity/liveness_image_verification/stateless
Last updated
Last updated
インターフェースを介してアップロードされた顔画像と生体認証データを比較して、画像内の顔が同一人物のものであるかどうかを判断します。
写真の規格は、運用マニュアルの3章 写真と動画の規格をご参照ください。
POST
顔比較スコアのしきい値とエラー率との対応関係
推奨しきい値:0.7 以上
フィールド
型
必須
説明
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
フィールド
型
説明
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
顔は検出されていますが、目、鼻、口が部分的に見えません
ステータスコード
ステータスフィールド
400
BAD_REQUEST
404
NOT_FOUND
411
LENGTH_REQUIRED
413
PAYLOAD_TOO_LARGE
500
INTERNAL_ERROR