裁剪图检索
使用人脸裁剪区域(小区域)进行 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-Type | application/json |
| Authorization | Bearer <token> |
| 参数 | 必填 | 说明 |
|---|---|---|
| images | 是 | 人脸裁剪(base64 和/或 HTTPS URL),同一主体 |
| min_score | 是 | 0.5–1 |
| search_mode | 是 | FAST 或 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 官方指南