通过

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

Face Recognition Operations - Group

  • 参考
服务:
Azure AI Services
API 版本:
v1.2-preview.1

根据人脸相似性将候选人脸划分为组。

    • 输出是一个或多个不相交的人脸组和一个混乱的组。 人脸组包含外观相似的人脸，通常是同一人脸。 人脸组按组大小（即人脸数）进行排名。 请注意，属于同一人的人脸可能拆分为结果中的多个组。
    • MessyGroup 是一个特殊的人脸组，其中包含无法从原始人脸中找到任何类似的对应人脸的人脸。 如果所有人脸都找到了对应人，则混乱组将不会出现在结果中。
    • 组 API 至少需要 2 个候选人脸和 1000 个。 建议在只有 2 张候选人脸时尝试“验证面对面”。
    • 与查询人脸关联的“recognitionModel”faceId 应相同。
POST {endpoint}/face/{apiVersion}/group

URI 参数

名称 在 必需 类型 说明
apiVersion
 path True

string

API 版本
endpoint
 path True

string

uri

支持的认知服务终结点（协议和主机名，例如：https://{resource-name}.cognitiveservices.azure.com）。

请求正文

名称 必需 类型 说明
faceIds True

string[]

由“Detect”创建的候选 faceId 数组。 最大值为 1000 张人脸。

响应

名称 类型 说明
200 OK

GroupingResult

成功的调用返回一个或多个相似人脸组（按组大小排名）和一个混乱组。
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

示例

Group Face IDs

示例请求

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426",
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "65d083d4-9447-47d1-af30-b626144bf0fb",
    "fce92aed-d578-4d2e-8114-068f8af4492e",
    "30ea1073-cc9e-4652-b1e3-d08fb7b95315",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e",
    "b64d5e15-8257-4af2-b20a-5a750f8940e7"
  ]
}

示例响应

状态代码:
200 
{
  "groups": [
    [
      "c5c24a82-6845-4031-9d5d-978df9175426",
      "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
      "fce92aed-d578-4d2e-8114-068f8af4492e",
      "b64d5e15-8257-4af2-b20a-5a750f8940e7"
    ],
    [
      "65d083d4-9447-47d1-af30-b626144bf0fb",
      "30ea1073-cc9e-4652-b1e3-d08fb7b95315"
    ]
  ],
  "messyGroup": [
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7",
    "fbd2a038-dbff-452c-8e79-2ee81b1aa84e"
  ]
}

定义

名称 说明
FaceError

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

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

组人脸操作的响应正文。

FaceError

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

名称 类型 说明
code

string

服务器定义的错误代码集之一。
message

string

错误的人工可读表示形式。

FaceErrorResponse

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

名称 类型 说明
error

FaceError

错误对象。

GroupingResult

组人脸操作的响应正文。

名称 类型 说明
groups

string[]

基于人脸相似性的原始人脸的分区。 组按人脸数进行排名。
messyGroup

string[]

人脸 ID 数组，这些人脸无法从原始人脸中找到任何相似的人脸。