Face Recognition Operations - Verify From Person Group

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

Проверьте, принадлежит ли лицо человеку в группе пользователей.

Примечание

• • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Для сценариев, которые чувствительны к точности, сделайте собственное суждение.
  • "recognitionModel", связанный с лицом запроса, должен совпадать с "recognitionModel", используемым группой пользователей.

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

Параметры URI

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

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

Имя	Обязательно	Тип	Описание
faceId	True	string	FaceId лица, поступают из "Detect".
personGroupId	True	string	Использование существующих personGroupId и personId для быстрой загрузки указанного пользователя. PersonGroupId создается в Create группе пользователей.
personId	True	string	Укажите определенного пользователя в разделе Группа пользователей.

Ответы

Имя	Тип	Описание
200 OK	VerificationResult	Успешный вызов возвращает результат проверки.
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

Примеры

Verify from PersonGroup

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

HTTP

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

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

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

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

200

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

Определения

Имя	Описание
FaceError	Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.
VerificationResult	Проверьте результат.

FaceError

Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.

Имя	Тип	Описание
code	string	Один из определяемого сервером набора кодов ошибок.
message	string	Удобочитаемое представление ошибки.

FaceErrorResponse

Ответ, содержащий сведения об ошибке.

Имя	Тип	Описание
error	FaceError	Объект error.

VerificationResult

Проверьте результат.

Имя	Тип	Описание
confidence	number	Число указывает на достоверность сходства того, принадлежат ли два лица одному и тому же человеку или лицо принадлежит ему. По умолчанию isIdentical имеет значение True, если достоверность сходства больше или равна 0,5. Это полезно для опытных пользователей, чтобы переопределить isIdentical и точно настроить результат на своих собственных данных.
isIdentical	boolean	Значение true, если два лица принадлежат одному и тому же человеку или лицо принадлежит человеку, в противном случае — false.