Face Recognition Operations - Identify From Large Person Group

  • Ссылка
Служба:
Azure AI Services
Версия API:
v1.2-preview.1

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

Заметка

    • Алгоритм позволяет определить несколько лиц независимо по одному запросу, но не более 10 лиц.
    • Каждый человек может иметь более одного лица, но не более 248 лиц.
    • Более высокое качество изображения лица означает лучшую точность идентификации. Рассмотрим высококачественные лица: фронтальные, четкие и размер лица составляет 200x200 пикселей (100 пикселей между глазами) или больше.
    • Количество возвращенных кандидатов ограничено maxNumOfCandidatesReturned и confidenceThreshold. Если пользователь не определен, возвращенные кандидаты будут пустым массивом.
    • Попробуйте найти похожие лица из списка лиц или большого списка лиц вместо группы пользователей или большой группы пользователей.
    • FaceIds распознавания лиц, связанных с запросом, должен совпадать с идентификаторами распознавания, используемыми целевой группой пользователей или группой крупных пользователей.
POST {endpoint}/face/{apiVersion}/identify

Параметры URI

Имя В Обязательно Тип Описание
apiVersion
 path True

string

Версия API
endpoint
 path True

string

uri

Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя ресурса}.cognitiveservices.azure.com).

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

Имя Обязательно Тип Описание
faceIds True

string[]

Массив лиц с лицом запроса, созданный методом "Обнаружение". Каждый из лиц определяется независимо. Допустимое число faceIds составляет от [1, 10].
largePersonGroupId True

string

largePersonGroupId целевой группы крупных пользователей, созданной группой крупных пользователей. Параметр personGroupId и largePersonGroupId не должны предоставляться одновременно.
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 LargePersonGroup

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

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "largePersonGroupId": "your_large_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

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

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

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

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

FaceError

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

Имя Тип Описание
code

string

Один из определяемых сервером кодов ошибок.
message

string

Читаемое пользователем представление ошибки.

FaceErrorResponse

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

Имя Тип Описание
error

FaceError

Объект ошибки.

IdentificationCandidate

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

Имя Тип Описание
confidence

number

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

string

personId кандидата.

IdentificationResult

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

Имя Тип Описание
candidates

IdentificationCandidate[]

Идентифицированные кандидаты на это лицо (рейтинг по достоверности). Размер массива не должен превышать размер входных данных maxNumOfCandidatesReturned. Если пользователь не определен, возвращает пустой массив.
faceId

string

faceId лица запроса.