Face - Verify Face To Face

服务:

Azure AI Services

API 版本:

1.0

验证两张人脸是否属于同一个人，或者一张人脸是否属于某一个人。
备注：

• 更高的人脸图像质量意味着更好的识别精度。 请考虑高质量的人脸：正面、清晰和人脸大小为 200x200 像素（眼睛之间的 100 像素）或更大。
• 对于对准确性敏感的方案，请做出自己的判断。
• 与查询人脸关联的“recognitionModel”faceId 应与目标人脸、人员组或大型人员组使用的“recognitionModel”相同。

POST {Endpoint}/face/v1.0/verify

URI 参数

名称	在	必需	类型	说明
Endpoint	path	True	string	支持的认知服务终结点（协议和主机名，例如：https://westus.api.cognitive.microsoft.com）。

请求头

名称	必需	类型	说明
Ocp-Apim-Subscription-Key	True	string

请求正文

名称	必需	类型	说明
faceId1	True	string (uuid)	第一张人脸的 FaceId 来自人脸 - 检测
faceId2	True	string (uuid)	第二张人脸的 FaceId 来自人脸 - 检测

响应

名称	类型	说明
200 OK	VerifyResult	成功的调用返回验证结果。
Other Status Codes	APIError	错误响应。

安全性

Ocp-Apim-Subscription-Key

类型: apiKey
在: header

示例

Verify faces example

示例请求

HTTP

POST {Endpoint}/face/v1.0/verify


{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "815df99c-598f-4926-930a-a734b3fd651c"
}

示例响应

状态代码:

200

{
  "isIdentical": true,
  "confidence": 0.9
}

定义

名称	说明
APIError	API 返回的错误信息
Error	错误正文。
VerifyFaceToFaceRequest	请求正文进行面对面验证。
VerifyResult	验证作的结果。

APIError

Object

API 返回的错误信息

名称	类型	说明
error	Error	错误正文。

Error

Object

错误正文。

名称	类型	说明
code	string
message	string

VerifyFaceToFaceRequest

Object

请求正文进行面对面验证。

名称	类型	说明
faceId1	string (uuid)	第一张人脸的 FaceId 来自人脸 - 检测
faceId2	string (uuid)	第二张人脸的 FaceId 来自人脸 - 检测

VerifyResult

Object

验证作的结果。

名称	类型	说明
confidence	number minimum: 0 maximum: 1	数字表示两张人脸是否属于同一人脸的相似性，或者人脸是否属于该人。 默认情况下，如果相似性置信度大于或等于 0.5，则 isIdentical 设置为 True。 这适用于高级用户重写“isIdentical”，并根据自己的数据微调结果。
isIdentical	boolean	如果两张人脸属于同一人或人脸属于该人，则为 True，否则为 false。