顔を検出
境界ボックスとスコアを使用して画像内の顔を特定します (Verifik 検出パイプライン)。
menu_bookAPI リファレンス: 顔検出expand_more
公式ドキュメント: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (顔検出の概要、サンプル ペイロード、応答形状)。
このデモでは、現在の API 検証で必要とされる min_score と search_mode を使用して、同じ POST /v2/face-recognition/detect ルートを呼び出します。オプションの collection_id と max_results はクライアントによってサポートされていますが、以下の形式では公開されていません。
POST /v2/face-recognition/detect
検出された顔をジオメトリとスコアとともに返します。公開されている顔検出ガイドには、サポートされている return_landmarks などのオプションのフラグも記載されています。
| ヘッダ | 価値 |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| パラメータ | 要求 | 説明 |
|---|---|---|
| image | はい | Base64 プローブ イメージ (生の Base64 または API ごとのデータ URI) |
| min_score | はい | しきい値、通常は 0.5 ～ 1 |
| search_mode | はい | 速いか正確か |
| collection_id | いいえ | オプションのスコープ (このデモ UI では使用されません) |
| max_results | いいえ | オプションのキャップ (このデモ UI では使用されません) |
await fetch("https://api.verifik.co/v2/face-recognition/detect", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: `Bearer ${accessToken}`,
},
body: JSON.stringify({
image: "<base64>",
min_score: 0.75,
search_mode: "FAST",
}),
});- このデモでは、セッション トークンで @humanauthn/api-client からの detectFace を使用します。
- キャプチャ後の 1:N 識別には、関連ドキュメントの顔検索またはライブ顔を検索を使用します。
menu_book
関連ドキュメント
docs.verifik.co の公式ガイド