1
ソース参照のみ2
ターゲットここに活気がある3
分析する出典・参考のみ
顔比較用にソースをギャラリーとして送信します。
Liveness は Source を使用しません。次のステップでターゲット上で実行されます。
menu_bookAPI リファレンス: liveness との比較expand_more
公式ドキュメント: docs.verifik.co/biometrics/compare-with-liveness
POST /v2/face-recognition/compare-with-liveness
まず比較してください。顔スコアがcompare_min_scoreを満たす(または省略された)場合、livenessはliveness_min_scoreに対してプローブ画像上で実行されます。
| ヘッダ | 価値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
このデモでは、ソースはギャラリー画像です (ステップ 1)。ターゲットはプローブです (ステップ 2)。オプションで、ソース内の最大の顔を検出し、送信前にブラウザーでその領域に画像をトリミングできます。ここではターゲット画像はトリミングされません。サーバー統合では、cropFace によるトリミングもサポートされる場合があります。
| パラメータ | タイプ | 要求 | 説明 |
|---|---|---|---|
| probe | string | はい | Base64 ライブ キャプチャ |
| gallery | string[] | はい | 参照画像 (base64、サーバー側でサポートされる https URL) |
| liveness_min_score | number | いいえ | 省略した場合のデフォルトは 0.6 |
| compare_min_score | number | いいえ | 0.67 ～ 0.95、オプションのしきい値 |
// 200 OK, example response shape
{
"data": {
"comparison": { "score": 0.88 },
"liveness": {
"liveness_score": 0.91,
"min_score": 0.6,
"passed": true
}
}
}- 比較が最初に実行されます。比較がしきい値を超えた場合 (またはしきい値が省略された場合) にのみ、プローブが活性化されます。
- liveness_min_score は、送信されない場合のデフォルトは 0.6 です。
- ギャラリーは https URL を使用する場合があります。サービスはそれらを取得して変換します。