Face Recognition Operations - Verify From Person Directory

Служба:

Azure AI Services

Версия API:

v1.2-preview.1

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

Заметка

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

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 лица, исходя из "Обнаружение".
personId	True	string	Укажите определенного пользователя в PersonDirectory Person.

Ответы

Имя	Тип	Описание
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 PersonDirectory

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

HTTP

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

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

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

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

200

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

Определения

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

FaceError

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

Имя	Тип	Описание
code	string	Один из определяемых сервером кодов ошибок.
message	string	Читаемое пользователем представление ошибки.

FaceErrorResponse

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

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

VerificationResult

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

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