裁剪图检索

裁剪图检索

使用人脸裁剪区域(小区域)进行 1:N 检索。min_score 必须在 0.5 与 1 之间。

menu_bookAPI 参考:人脸检索 1:N(裁剪)expand_more

官方文档: docs.verifik.co/biometrics/search-crops (人脸裁剪的 1:N 检索;min_score 为 0.5–1,与标准人脸检索不同)。

基础 URL 为 https://api.verifik.co。在 images 中发送一条或多条原始 base64 或 HTTPS 图像 URL(API 可能服务端拉取 URL)。可选 collection_id 与 max_results。

POST /v2/face-recognition/search/crops

在 data 中返回排序后的候选人员,总体形状与 /face-recognition/search 类似。

字段
Content-Typeapplication/json
AuthorizationBearer <token>
参数必填说明
images人脸裁剪(base64 和/或 HTTPS URL),同一主体
min_score0.5–1
search_modeFAST 或 ACCURATE
collection_id将检索限定在单个人脸库
max_results返回匹配数量上限
await searchCrops(
  {
    images: ["<base64>", "<base64>"],
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
    max_results: 10,
  },
  accessToken,
);
  • 本演示使用 @humanauthn/api-client 的 searchCrops 及您的会话令牌。
  • 响应通常包含排序后的匹配,并可能包含签名字段,视环境而定。
menu_book

docs.verifik.co 官方指南