検索者
顔画像をアップロードし、類似度(1:N)で登録者を検索します。
menu_bookAPI リファレンス: 顔検索 (1:N)expand_more
公式ドキュメント: docs.verifik.co/biometrics/search (顔検索 — 登録者に対して顔画像による検索)。
Base URL https://api.verifik.co. Send one or more raw base64 images of the same subject in images (no data URL prefix). Optionally scope with collection_id. The public docs recommend 1–3 images for better recall.
POST /v2/face-recognition/search
1:N 識別: 類似性スコアによってランク付けされた候補者を返します。
| ヘッダ | 価値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| パラメータ | 要求 | 説明 |
|---|---|---|
| images | はい | Base64 顔画像の配列 (同一人物、最大 3 つまで提案) |
| min_score | はい | 一致しきい値 (例: 0.2 ～ 1.0) |
| search_mode | はい | 速いか正確か |
| collection_id | いいえ | 検索を 1 つのコレクションに限定する |
| max_results | いいえ | 返される一致の上限 (省略した場合は API のデフォルトが適用されます) |
await fetch("https://api.verifik.co/v2/face-recognition/search", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
images: ["<base64>", "<base64>"],
collection_id: "<optionalCollectionMongoId>",
min_score: 0.75,
search_mode: "FAST",
}),
});- このデモでは、セッション トークンで @humanauthn/api-client の searchperson を使用します。
- 通常、応答にはランク付けされた一致が含まれ、環境によっては署名ブロックが含まれる場合があります。
menu_book
関連ドキュメント
docs.verifik.co の公式ガイド