6.3.1. /liveness/silent_detection/stateless
サイレント生体検知のインターフェースです。
リクエストモード
POST
リクエスト URL
リクエストパラメーター
フィールド | 型 | 必須 | 説明 |
encrypted_video | String | Yes | 暗号化された動画。暗号化方法の参照: 個人データの暗号化 |
return_image | boolean | No | 選出されたフレーム画像と選出されたフレーム画像のタイムスタンプを返すかどうか。 デフォルト値は false で、値が true かつ生体認証が通過した場合に |
return_face_image | boolean | No | 選出されたフレーム画像の顔のクロップを返すかどうか。 デフォルト値は false で、値が true かつ生体認証が通過した場合に |
return_status | boolean | No | エラーステータスの説明を返すかどうかを指定します。デフォルトはfalseで、値がtrueの場合にのみ |
一般的なビデオフォーマットはサポートされています。例えば: .mp4, .avi, .flv, .wmv, .mov, .rm
通常のレスポンス
フィールド | 型 | 説明 |
request_id | string | リクエストのID |
code | int | システムレスポンスコード: 1000 |
passed | boolean | 生体認証に通過したかどうか |
liveness_score | float | サイレント生体認証のスコア(参考までに、結果はpassedフィールドを使用してください) |
liveness_status | string | サイレントライブネス検出のエラー状態を記述します。このフィールドは、return_status=true の時に返されます |
image_timestamp | float | 選出されたフレームのタイムスタンプを秒単位で表し、passed=true、return_image=trueの場合に返されます |
base64_image | string | 選出されたフレーム画像、passed=true、return_image=trueの場合は該当フィールドを返します |
base64_face_image | string | 選出された顔写真の切り抜き、passed=true、return_face_image=trueの場合に返されます |
ここで、liveness_status
の結果は以下のようになる:
ステータス | 説明 |
ok | サイレント生体認証は合格した: 動画の中の人は実在する |
hack | サイレント生体認証は合格してない、理由: 捏造した顔 (例えば, ビデオで撮影された顔) |
short_time | サイレント生体認証は合格してない、理由: ビデオの持続時間は2s未満 |
no_face_detected | サイレント生体認証は合格してない、理由: 映像から顔は検出されません |
loss_tracking | サイレント生体認証は合格してない、理由: 途中で顔がフレームアウト |
face_changed | サイレント生体認証は合格してない、理由: 動画の途中で顔が入れ替わっていました |
face_occlusion | サイレント生体認証は合格してない、理由: 一定期間顔が見えなくなる |
異常なレスポンス
フィールド | 型 | 説明 |
request_id | string | リクエストのID |
code | int | システムレスポンスコード |
message | string | エラーメッセージ |
システムレスポンスコードの説明
コード | フィールドの値 | 説明 |
1200 | invalid argument | 無効な入力パラメーター |
2008 | invalid video error | 無効な動画 |
4007 | liveness silent check failed | サイレント生体認証失敗 |
可能性のある http ステータスコード:
ステータスコード | ステータスフィールド |
400 | BAD_REQUEST |
404 | NOT_FOUND |
411 | LENGTH_REQUIRED |
413 | PAYLOAD_TOO_LARGE |
500 | INTERNAL_ERROR |
使用サンプル
curl サンプル
Java サンプル
Last updated