Face Recognition Operations - Group

Служба:

Azure AI Services

Версия API:

v1.2-preview.1

Разделить кандидаты на группы на основе сходства лиц.

• • Выходные данные являются одной или несколькими несвязанными группами лиц и беспорядочной группой. Группа лиц содержит лица, которые имеют похожий вид, часто одного и того же человека. Группы лиц ранжируются по размеру группы, т. е. количеству лиц. Обратите внимание, что лица, принадлежащие одному человеку, могут быть разделены на несколько групп в результате.
  • MessyGroup — это специальная группа лиц, содержащая лица, которые не могут найти аналогичное лицо с исходных лиц. МессиГруппа не будет отображаться в результате, если все лица нашли своих коллег.
  • Api групп требует не менее 2 кандидатов и 1000 в большинстве случаев. Мы рекомендуем попробовать "Проверить лицо перед лицом", если у вас есть только 2 кандидата лица.
  • Идентификаторы распознавания лиц запроса, связанные с лицом запроса, должны совпадать.

POST {endpoint}/face/{apiVersion}/group

Параметры URI

Имя	В	Обязательно	Тип	Описание
apiVersion	path	True	string	Версия API
endpoint	path	True	string uri	Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя ресурса}.cognitiveservices.azure.com).

Текст запроса

Имя	Обязательно	Тип	Описание
faceIds	True	string[]	Массив кандидатов faceId, созданных с помощью функции "Обнаружение". Максимальное значение — 1000 лиц.

Ответы

Имя	Тип	Описание
200 OK	GroupingResult	Успешный вызов возвращает одну или несколько групп похожих лиц (ранг по размеру группы) и грязную группу.
Other Status Codes	FaceErrorResponse	Непредвиденное сообщение об ошибке. Заголовки x-ms-error-code: string

Безопасность

Ocp-Apim-Subscription-Key

Секретный ключ для подписки Azure AI Face.

Тип: apiKey
В: header

AADToken

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: accessCode
URL-адрес авторизации: https://api.example.com/oauth2/authorize
URL-адрес токена: https://api.example.com/oauth2/token

Области

Имя	Описание
https://cognitiveservices.azure.com/.default

Примеры

Group Face IDs

Образец запроса

HTTP

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[]	Массив идентификаторов лиц, которые не могут найти похожие лица с исходных лиц.