Face Recognition Operations - Identify From Dynamic Person Group
Идентификация "1 ко многим", чтобы найти ближайшие совпадения лица конкретного пользователя запроса из группы динамических пользователей.
Для каждого лица в массиве faceIds face Identify вычисляет сходство между лицом запроса и всеми лицами в группе динамических пользователей (задано dynamicPersonGroupId) и возвращает людей-кандидатов для этого лица, ранжированных по достоверности сходства.
Примечание
-
- Алгоритм позволяет независимо идентифицировать несколько лиц по одному запросу, но не более 10 лиц.
- Каждый человек может иметь более одного лица, но не более 248 лиц.
- Более высокое качество изображения лица означает лучшую точность идентификации. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Количество возвращаемых кандидатов ограничено значениями maxNumOfCandidatesReturned и confidenceThreshold. Если никто не идентифицируется, возвращенные кандидаты будут пустым массивом.
- Операция Идентификация может сопоставлять только лица, полученные с той же моделью распознавания, которая связана с лицами запроса.
POST {endpoint}/face/{apiVersion}/identify
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api
|
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 |
Успешный вызов возвращает определенных потенциальных пользователей для каждого лица запроса. |
|
Other Status Codes |
Непредвиденное сообщение об ошибке. Заголовки 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
Образец запроса
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
}
Пример ответа
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Определения
Имя | Описание |
---|---|
Face |
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages. |
Face |
Ответ, содержащий сведения об ошибке. |
Identification |
Кандидат для идентификации вызова. |
Identification |
Определение результата. |
FaceError
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
Имя | Тип | Описание |
---|---|---|
code |
string |
Один из определяемого сервером набора кодов ошибок. |
message |
string |
Удобочитаемое представление ошибки. |
FaceErrorResponse
Ответ, содержащий сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |
IdentificationCandidate
Кандидат для идентификации вызова.
Имя | Тип | Описание |
---|---|---|
confidence |
number |
Значение достоверности кандидата. Чем выше достоверность, тем более похожим. Диапазон между [0,1]. |
personId |
string |
personId кандидата. |
IdentificationResult
Определение результата.
Имя | Тип | Описание |
---|---|---|
candidates |
Идентифицированные кандидаты на это лицо (ранжируется по достоверности). Размер массива не должен превышать значение input maxNumOfCandidatesReturned. Если ни один человек не идентифицируется, возвращает пустой массив. |
|
faceId |
string |
faceId лица запроса. |