你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Face Recognition Operations - Verify From Person Directory

服务:

Azure AI Services

API 版本:

v1.2-preview.1

验证人脸是否属于人员目录中的人员。

注意

• • 更高的人脸图像质量意味着更好的识别精度。 请考虑高质量的人脸：正面、清晰和人脸大小为 200x200 像素（眼睛之间的 100 像素）或更大。
  • 对于对准确性敏感的方案，请做出自己的判断。
  • Verify 操作只能匹配与查询人脸关联的同一识别模型获取的人脸。

POST {endpoint}/face/{apiVersion}/verify

URI 参数

名称	在	必需	类型	说明
apiVersion	path	True	string	API 版本
endpoint	path	True	string uri	支持的认知服务终结点（协议和主机名，例如：https://{resource-name}.cognitiveservices.azure.com）。

请求正文

名称	必需	类型	说明
faceId	True	string	人脸的 faceId 来自“Detect”。
personId	True	string	在 PersonDirectory Person 中指定特定人员。

响应

名称	类型	说明
200 OK	VerificationResult	成功的调用返回验证结果。
Other Status Codes	FaceErrorResponse	意外的错误响应。 标头 x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 人脸订阅的密钥。

类型: apiKey
在: header

AADToken

Azure Active Directory OAuth2 流

类型: oauth2
流向: accessCode
授权 URL: https://api.example.com/oauth2/authorize
令牌 URL: https://api.example.com/oauth2/token

作用域

名称	说明
https://cognitiveservices.azure.com/.default

示例

Verify from PersonDirectory

示例请求

HTTP

POST {endpoint}/face/v1.2-preview.1/verify

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

示例响应

状态代码:

200

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

定义

名称	说明
FaceError	错误对象。 有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。
FaceErrorResponse	包含错误详细信息的响应。
VerificationResult	验证结果。

FaceError

错误对象。 有关人脸服务返回的错误代码和消息的综合详细信息，请参阅以下链接：https://aka.ms/face-error-codes-and-messages。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
message	string	错误的人工可读表示形式。

FaceErrorResponse

包含错误详细信息的响应。

名称	类型	说明
error	FaceError	错误对象。

VerificationResult

验证结果。

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