Face Recognition Operations - Identify From Large Person Group

Служба:

Azure AI Services

Версия API:

v1.1-preview.1

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

Примечание

• • Алгоритм позволяет идентифицировать более одного лица независимо по одному запросу, но не более 10 лиц.
  • Каждый человек может иметь более одного лица, но не более 248 лиц.
  • Более высокое качество изображения лица означает лучшую точность идентификации. Пожалуйста, рассмотрите высококачественные лица: фронтальные, четкие и размер лица 200 x 200 пикселей (100 пикселей между глазами) или больше.
  • Количество возвращаемых кандидатов ограничивается maxNumOfCandidatesReturned и confidenceThreshold. Если пользователь не идентифицируется, возвращенные кандидаты будут пустым массивом.
  • Попробуйте "Найти похожие", если вам нужно найти похожие лица из списка лиц или большого списка лиц вместо группы пользователей или большой группы людей.
  • Идентификаторы faceId "recognitionModel", связанные с лицами запроса, должны совпадать с идентификаторами распознавания, используемыми целевой группой пользователей или группой больших пользователей.

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[]	Массив лиц запросов лиц, созданных с помощью функции "Detect". Каждое лицо идентифицируется независимо. Допустимое число идентификаторов лиц находится в диапазоне от [1, 10].
largePersonGroupId	True	string	largePersonGroupId целевой группы больших пользователей, созданной Create большой группы пользователей. Параметры 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

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

HTTP

POST {endpoint}/face/v1.1-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 лица запроса.