6.1.3. /identity/liveness_image_verification/stateless
インターフェースを介してアップロードされた顔画像と生体認証データを比較して、画像内の顔が同一人物のものであるかどうかを判断します。
画像は、以下の要件を満たすものとします。
JPG (JPEG)、BMP、PNG、GIF、TIFF のいずれかの形式
幅と高さは 8 px 以上 5,000 px 以下
ファイルサイズは 5 MB 以下
リクエストモード
POST
リクエスト URL
リクエストパラメーター
フィールド | 型 | 必須 | 説明 |
liveness_file | File | Yes | インタラクティブ・ライブネスまたはサイレント・ライブネスSDKによる検出に成功した後に返された暗号化されたバイナリ・ストリーム・ファイル(i.e. protobufData)です。別途の暗号化を必要とせずに既に暗号化されています。 |
encrypted_image | String | Yes | 暗号化された画像 。暗号化方法の参照: 個人データの暗号化 |
auto_rotate | boolean | No | デフォルト値は false で、画像が回転していないことを示します。値が true の場合、画像は自動的に回転されます。 |
check_quality | boolean | No | デフォルト値が false の場合は品質チェックを行わず、true の場合は画像の品質チェックを行います。 |
通常のレスポンス
フィールド | 型 | 説明 |
request_id | string | このリクエストのID |
code | int | システムレスポンスコード: 1000 |
verification_score | float | 顔照合スコア、値0~1、値が高いほど同一人物である可能性が高いことです。 |
顔比較スコアの閾値とエラー率との対応関係:
閾値 | 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 以上
異常なレスポンス
フィールド | 型 | 説明 |
request_id | string | このリクエストのID |
code | int | システムレスポンスコード |
message | string | エラーメッセージ |
システムレスポンスコードの説明
コード | フィールドの値 | 説明 |
1200 | invalid argument | 無効な入力パラメーター |
2003 | invalid image size | 画像サイズが要件を満たしていません |
2004 | invalid content length | 画像コンテンツの長さが要件を満たしていません |
2005 | invalid image type | 画像タイプが要件を満たしていません |
2006 | corrupted image 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