人脸检测

人脸检测

在图像中定位人脸,返回边界框与分数(Verifik 检测流水线)。

menu_bookAPI 参考:人脸检测expand_more

官方文档: docs.verifik.co/verifik-biometrics-apis/liveness/face-detection (人脸检测概览、示例载荷与响应结构)。

本演示调用相同的 POST /v2/face-recognition/detect 路由,按当前 API 校验要求传入 min_score 与 search_mode。客户端支持可选 collection_id 与 max_results,但下方表单未暴露。

POST /v2/face-recognition/detect

返回带几何与分数的检测人脸。已发布的人脸检测指南还记录 return_landmarks 等可选标志(若支持)。

字段
Content-Typeapplication/json
AuthorizationBearer <token>
参数必填说明
imagebase64 探针图(原始 base64 或按 API 的 data URI)
min_score阈值,通常为 0.5–1
search_modeFAST 或 ACCURATE
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 官方指南