生きている人物を検索
1 つのプローブ画像のライブネス、その後 1:N の顔検索 (ライブ)。
menu_bookAPI リファレンス: 顔検索 1:N (ライブ)expand_more
公式ドキュメント: docs.verifik.co/biometrics/search-live-face (プローブ画像上の活性、その後 1:N 検索)。
Base URL https://api.verifik.co. Send a single raw base64 probe in image (no data URL prefix), required os (ANDROID, IOS, or DESKTOP), liveness and match thresholds, and search_mode. This demo uses DESKTOP.
POST /v2/face-recognition/search-live-face
最初にアンチスプーフィング/ライブネスを実行します。合格した場合は、登録された顔に対して類似性検索を実行します。
| ヘッダ | 価値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| パラメータ | 要求 | 説明 |
|---|---|---|
| image | はい | 単一のbase64プローブ画像 |
| os | はい | アンドロイド、IOS、またはデスクトップ |
| liveness_min_score | はい | 生存閾値 (0.5 ~ 1.0) |
| min_score | はい | 一致しきい値 (ドキュメントあたり 0.5 ~ 1.0) |
| search_mode | はい | 速いか正確か |
| collection_id | いいえ | 検索範囲を 1 つのコレクションに限定 |
await fetch("https://api.verifik.co/v2/face-recognition/search-live-face", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
os: "DESKTOP",
liveness_min_score: 0.65,
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
}),
});- このデモでは、セッション トークンを使用して @humanauthn/api-client からの searchLiveperson を使用します。
- 活性しきい値を下回る障害が発生すると、エラー応答が返される場合があります (エラーの形状については API ドキュメントを参照してください)。
menu_book
関連ドキュメント
docs.verifik.co の公式ガイド