人脸比对
下载
聚焦模式
字号
功能描述
支持用一张待检测的人脸图片，从数据集中检索最相似的前 N 张人脸图片。
授权说明
服务开通
首次使用该功能时将默认为您开通数据万象，同时该存储桶将自动绑定数据万象，无需角色授权，即可直接使用。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。
使用限制
使用检索前需要先完成 创建数据集。
仅支持雅加达地域，即请求 Host 中的
Region 仅支持填写为 ap-jakarta。更多使用限制，详情请参见 使用限制。
费用说明
请求
请求示例
POST /datasetquery/facesearch HTTP/1.1Host: <AppId>.ci.ap-jakarta.myqcloud.comAuthorization: Auth StringContent-Length: xxxContent-Type: application/jsonAccept: application/json
说明：
请求头
请求体
{"DatasetName": "test","URI": "cos://examplebucket-1250000000/test.jpg","MaxFaceNum": 1,"Limit": 10,"MatchThreshold": 10}
请求参数
参数名称 | 描述 | 类型 | 是否必选 |
DatasetName | String | 是 | |
URI | 资源标识字段，表示需要建立索引的文件地址 | String | 是 |
MaxFaceNum | 输入图片中检索的人脸数量，默认值为1(传0或不传采用默认值)，最大值为10 | Integer | 否 |
Limit | 检索的每张人脸返回相关人脸数量，默认值为10，最大值为100 | Integer | 否 |
MatchThreshold | 限制返回人脸的最低相关度分数，只有超过 MatchThreshold 值的人脸才会返回。默认值为0，推荐值为80 例如：设置 MatchThreshold 的值为80，则检索结果中仅会返回相关度分数大于等于80分的人脸 | Integer | 否 |
响应
响应头
响应体
{"FaceResult": [{"FaceInfos": [{"PersonId": "xxxxx","FaceBoundary": {"Height": 264,"Width": 203,"Left": 353,"Top": 90},"FaceId": "80c10056-1d40-418b-9f4f-dabf8e8cc349","Score": 76,"URI": "cos://facesearch-1258726280/huge_hezao.webp"}],"InputFaceBoundary": {"Height": 545,"Width": 401,"Left": 737,"Top": 191}}],"RequestId": "NjYxNTMyY2JfNGQ2ODk0MGJfNzAzZl81"}
响应包体具体数据内容如下：
参数名称 | 类型 | 描述 |
FaceResult | Container Array | 人脸检索识别结果信息列表 |
RequestId | String | 请求 ID |
FaceResult 节点内容：
参数名称 | 类型 | 描述 |
FaceInfos | Container Array | 相关人脸信息列表 |
InputFaceBoundary | Container | 输入图片的人脸框位置 |
FaceInfos 节点内容：
参数名称 | 类型 | 描述 |
PersonId | String | 自定义人物 ID |
FaceBoundary | Container | 相关人脸框位置 |
FaceId | String | 人脸 ID |
Score | Integer | 相关人脸匹配得分 |
URI | String | 资源标识字段，表示需要建立索引的文件地址 |
FaceBoundary 节点内容：
参数名称 | 类型 | 描述 |
Height | Integer | 人脸高度 |
Width | Integer | 人脸宽度 |
Left | Integer | 人脸框左上角横坐标 |
Top | Integer | 人脸框左上角纵坐标 |
InputFaceBoundary 节点内容：
参数名称 | 类型 | 描述 |
Height | Integer | 人脸高度 |
Width | Integer | 人脸宽度 |
Left | Integer | 人脸框左上角横坐标 |
Top | Integer | 人脸框左上角纵坐标 |
使用案例
请求：进行人脸检索搭配标量过滤
POST /datasetquery/facesearch HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************Host: 1234567890.ci.ap-jakarta.myqcloud.comContent-Length: 166Content-Type: application/jsonAccept: application/json{"DatasetName": "test","URI": "cos://examplebucket-1250000000/test.jpg","MaxFaceNum": 1,"Limit": 10,"MatchThreshold": 10}
响应
HTTP/1.1 200 OKContent-Type: application/jsonContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc={"FaceResult": [{"FaceInfos": [{"PersonId": "xxxxx","FaceBoundary": {"Height": 264,"Width": 203,"Left": 353,"Top": 90},"FaceId": "80c10056-1d40-418b-9f4f-dabf8e8cc349","Score": 76,"URI": "cos://facesearch-1258726280/huge_hezao.webp"}],"InputFaceBoundary": {"Height": 545,"Width": 401,"Left": 737,"Top": 191}}],"RequestId": "NjYxNTMyY2JfNGQ2ODk0MGJfNzAzZl81"}
错误码
文档反馈