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

Face Recognition Operations - Identify From Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

1 对多标识，用于从人员组中查找特定查询人员人脸的最接近匹配项。
对于 faceIds 数组中的每个人脸，人脸识别将计算查询人脸与 person Group) (中的所有人脸之间的相似性，并返回按相似度置信度排名的该人脸的候选人员 () 。 应对人员组进行培训，使其做好识别准备。 有关详细信息，请参阅“培训人员组”。

注意

• • 该算法允许在同一请求中独立识别多个人脸，但不超过 10 张人脸。
  • 每个人可以有多个人脸，但不超过 248 张脸。
  • 更高的人脸图像质量意味着更好的识别精度。 请考虑高质量的人脸：正面、清晰，人脸大小为 200x200 像素 (100 像素，眼睛之间) 或更大。
  • 返回的候选项数受 maxNumOfCandidatesReturned 和 confidenceThreshold 的限制。 如果未标识人员，则返回的候选项将为空数组。
  • 如果需要从人脸列表/大型人脸列表中而不是人员组中查找相似人脸，请尝试“查找相似人脸”。
  • 与查询人脸关联的“recognitionModel”faceIds 应与目标人员组使用的“recognitionModel”相同。

POST {endpoint}/face/{apiVersion}/identify

URI 参数

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

请求正文

名称	必需	类型	说明
faceIds	True	string[]	由“Detect”创建的查询人脸 faceIds 数组。 每个人脸都是独立标识的。 faceIds 的有效数目在 [1， 10] 之间。
personGroupId	True	string	目标人员组的 personGroupId，由“Create Person Group”创建。 不应同时提供参数 personGroupId 和 largePersonGroupId。
confidenceThreshold		number	自定义的标识置信度阈值，范围为 [0， 1]。 高级用户可以调整此值，以覆盖默认的内部阈值，以提高其方案数据的精度。 请注意，无法保证此阈值适用于其他数据和算法更新之后。
maxNumOfCandidatesReturned		integer	maxNumOfCandidatesReturned 的范围介于 1 和 100 之间。 默认值为 10。

响应

名称	类型	说明
200 OK	IdentificationResult[]	成功的调用将返回已识别的候选人员 (每个查询人脸的) 。
Other Status Codes	FaceErrorResponse	意外的错误响应。 Headers x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 人脸订阅的密钥。

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 流

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

示例

Identify from PersonGroup

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/identify

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Sample Response

Status code:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

定义

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

FaceError

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

名称	类型	说明
code	string	服务器定义的一组错误代码中的一个。
message	string	错误的用户可读表示形式。

FaceErrorResponse

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

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

IdentificationCandidate

识别呼叫的候选项。

名称	类型	说明
confidence	number	候选项的置信度值。 置信度越高，越相似。 范围介于 [0,1] 之间。
personId	string	personId 的候选人员。

IdentificationResult

标识结果。

名称	类型	说明
candidates	IdentificationCandidate[]	该人脸的已确定人选 (按信心) 排名。 数组大小不应大于输入 maxNumOfCandidatesReturned。 如果未标识任何人，将返回一个空数组。
faceId	string	查询人脸的 faceId。