Face - Verify Face To Face

  • Ссылка
Service:
Cognitive Services - Face
API Version:
1.0

Проверяет, принадлежат ли два лица одному пользователю или принадлежит ли лицо пользователю.
Примечания:

  • Более высокое качество изображения лица означает лучшую точность идентификации. Рассмотрим высококачественные лица: передние, ясные и размеры лица 200x200 пикселей (100 пикселей между глазами) или больше.
  • Для сценариев, чувствительных к точности, сделайте свое собственное решение.
  • FaceIds "recognitionModel", связанный с запросом, должен совпадать с faceIds "recognitionModel", используемым целевым лицом, группой пользователей или большой группой пользователей.
POST {Endpoint}/face/v1.0/verify

Параметры URI

Name In Required Type Description
Endpoint
 path True
  • string

Поддерживаемые конечные точки Cognitive Services (например, https://westus.api.cognitive.microsoft.comимя протокола и узла).

Заголовок запроса

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

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

Name Required Type Description
faceId1 True
  • string

FaceId первого лица, поступает из Face - Detect
faceId2 True
  • string

FaceId второго лица, поступает из Face - Detect

Ответы

Name Type Description
200 OK

Успешный вызов возвращает результат проверки.
Other Status Codes

Ответ на ошибку.

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

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Примеры

Verify faces example

Sample Request

POST {Endpoint}/face/v1.0/verify


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

Sample Response

Status code:
200 
{
  "isIdentical": true,
  "confidence": 0.9
}

Определения

APIError

Сведения об ошибке, возвращаемые API
Error

Текст ошибки.
VerifyFaceToFaceRequest

Запрос текста для проверки лиц.
VerifyResult

Результат операции проверки.

APIError

Сведения об ошибке, возвращаемые API

Name Type Description
error

Текст ошибки.

Error

Текст ошибки.

Name Type Description
code
  • string
message
  • string

VerifyFaceToFaceRequest

Запрос текста для проверки лиц.

Name Type Description
faceId1
  • string

FaceId первого лица, поступает из Face - Detect
faceId2
  • string

FaceId второго лица, поступает из Face - Detect

VerifyResult

Результат операции проверки.

Name Type Description
confidence
  • number

Число указывает на достоверность сходства двух лиц, принадлежащих одному человеку, или лицо принадлежит человеку. По умолчанию параметр isIdentical имеет значение True, если достоверность сходства больше или равна 0,5. Это полезно для опытных пользователей, чтобы переопределить isIdentical и точно настроить результат на собственных данных.
isIdentical
  • boolean

Значение true, если два лица принадлежат одному человеку или лицо принадлежит человеку, в противном случае — false.