Face Recognition Operations - Identify From Dynamic Person Group

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

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

Примечание

• • Алгоритм позволяет независимо идентифицировать несколько лиц по одному запросу, но не более 10 лиц.
  • Каждый человек может иметь более одного лица, но не более 248 лиц.
  • Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (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).

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

Имя	Обязательно	Тип	Описание
dynamicPersonGroupId	True	string	DynamicPersonGroupId целевого объекта PersonDirectory DynamicPersonGroup для сопоставления.
faceIds	True	string[]	Массив лиц запроса faceId, созданный с помощью функции "Detect". Каждое лицо определяется независимо друг от друга. Допустимое число идентификаторов faceId находится в диапазоне от [1, 10].
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 DynamicPersonGroup

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

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "dynamicPersonGroupId": "your_dynamic_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	Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Ответ, содержащий сведения об ошибке.
IdentificationCandidate	Кандидат для идентификации вызова.
IdentificationResult	Определение результата.

FaceError

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

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

FaceErrorResponse

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

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

IdentificationCandidate

Кандидат для идентификации вызова.

Имя	Тип	Описание
confidence	number	Значение достоверности кандидата. Чем выше достоверность, тем более похожим. Диапазон между [0,1].
personId	string	personId кандидата.

IdentificationResult

Определение результата.

Имя	Тип	Описание
candidates	IdentificationCandidate[]	Идентифицированные кандидаты на это лицо (ранжируется по достоверности). Размер массива не должен превышать значение input maxNumOfCandidatesReturned. Если ни один человек не идентифицируется, возвращает пустой массив.
faceId	string	faceId лица запроса.