Face Recognition Operations - Identify From Person Group

Служба:

Azure AI Services

Версия API:

v1.2-preview.1

1 ко многим идентификация, чтобы найти ближайшие совпадения конкретного пользователя запроса лица из группы пользователей.
Для каждого лица в массиве faceIds распознавание лиц вычисляет сходство между лицом запроса и всеми лицами в группе лиц (с учетом personGroupId) и возвратом лиц-кандидатов для этого лица, ранжированных по достоверности сходства. Группа лиц должна быть обучена, чтобы подготовить ее к идентификации. Дополнительные возможности см. в разделе "Обучение группы пользователей".

Заметка

• • Алгоритм позволяет определить несколько лиц независимо по одному запросу, но не более 10 лиц.
  • Каждый человек может иметь более одного лица, но не более 248 лиц.
  • Более высокое качество изображения лица означает лучшую точность идентификации. Рассмотрим высококачественные лица: фронтальные, четкие и размер лица составляет 200x200 пикселей (100 пикселей между глазами) или больше.
  • Количество возвращенных кандидатов ограничено maxNumOfCandidatesReturned и confidenceThreshold. Если пользователь не определен, возвращенные кандидаты будут пустым массивом.
  • Попробуйте найти похожие лица из списка лиц или большого списка лиц вместо группы лиц.
  • Идентификаторы распознавания лиц, связанные с лицом запроса, должны совпадать с идентификаторами распознавания, используемыми целевой группой лиц.

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

Параметры URI

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

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

Имя	Обязательно	Тип	Описание
faceIds	True	string[]	Массив лиц с лицом запроса, созданный методом "Обнаружение". Каждый из лиц определяется независимо. Допустимое число faceIds составляет от [1, 10].
personGroupId	True	string	personGroupId целевой группы пользователей, созданной с помощью команды "Создать группу пользователей". Параметр personGroupId и largePersonGroupId не должны предоставляться одновременно.
confidenceThreshold		number	Настраиваемое пороговое значение достоверности идентификации в диапазоне [0, 1]. Расширенный пользователь может изменить это значение, чтобы переопределить внутреннее пороговое значение по умолчанию для повышения точности данных сценария. Обратите внимание, что это пороговое значение не гарантируется, что оно работает с другими данными и после обновлений алгоритма.
maxNumOfCandidatesReturned		integer	Диапазон maxNumOfCandidatesReturned составляет от 1 до 100. Значение по умолчанию — 10.

Ответы

Имя	Тип	Описание
200 OK	IdentificationResult[]	Успешный вызов возвращает идентифицированные лица-кандидаты для каждого лица запроса.
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

Примеры

Identify from PersonGroup

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

HTTP

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

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

Пример ответа

Код состояния:

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 лица запроса.