Person Group Operations - Add Person Group Person Face From Url
Добавление лица к человеку в группу пользователей для идентификации или проверки лица.
Для обработки изображения, содержащего несколько лиц, входные лица можно указать как изображение с прямоугольником targetFace. Он возвращает значение persistedFaceId, представляющее добавленное лицо. Образ не будет сохранен. Только извлеченные функции распознавания лиц будут храниться на сервере, пока не будет вызвана команда "Удалить лицо пользователя группы пользователей", "Удалить пользователя группы пользователей" или "Удалить группу пользователей".
Обратите внимание, что persistedFaceId отличается от faceId, созданного параметром "Detect".
-
- Более высокое качество изображения лица означает лучшую точность распознавания. Учитывайте высококачественные лица: лобные, четкие, а размер лица — 200 x 200 пикселей (100 пикселей между глазами) или больше.
- Каждая запись может содержать до 248 лиц.
- Поддерживаются форматы JPEG, PNG, GIF (первый кадр) и BMP. Допустимый размер файла изображения — от 1 КБ до 6 МБ.
- Прямоугольник targetFace должен содержать одно лицо. Ноль или несколько лиц будут рассматриваться как ошибка. Если указанный прямоугольник targetFace не возвращается из элемента "Detect", нет никакой гарантии успешного обнаружения и добавления лица.
- Из-за определяемого размера лица (36x36–4096 x 4096 пикселей), большого положения головы или больших окклюзий приведут к сбоям.
- Минимальный размер обнаруживаемого лица составляет 36 x 36 пикселей на изображении размером не более 1920 x 1080 пикселей. Изображениям с размерами выше 1920x1080 пикселей потребуется пропорционально больший минимальный размер лица.
- Можно указать различные значения detectionModel. Сведения об использовании и сравнении различных моделей обнаружения см. в статье https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces
POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces?targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
api
|
path | True |
string |
Версия API |
endpoint
|
path | True |
string uri |
Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://{имя_ресурса}.cognitiveservices.azure.com). |
person
|
path | True |
string |
Идентификатор контейнера. Шаблон регулярного выражения: |
person
|
path | True |
string uuid |
Идентификатор пользователя. |
detection
|
query |
Объект detectionModel, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01". |
||
target
|
query |
integer[] |
Прямоугольник лица, указывающий целевое лицо, добавляемое к человеку, в формате "targetFace=left,top,width,height". |
|
user
|
query |
string |
Предоставленные пользователем данные, прикрепленные к лицу. Максимальный размер — 1 КБ. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
url | True |
string |
URL-адрес входного изображения. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
При успешном вызове возвращается новый persistedFaceId. |
|
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 |
Примеры
Add Face to PersonGroupPerson from Url
Образец запроса
POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data
{
"url": "https://microsoft.com/example.jpg"
}
Пример ответа
{
"persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}
Определения
Имя | Описание |
---|---|
Add |
Текст ответа для добавления лица. |
Detection |
Объект detectionModel, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01". |
Face |
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages. |
Face |
Ответ, содержащий сведения об ошибке. |
AddFaceResult
Текст ответа для добавления лица.
Имя | Тип | Описание |
---|---|---|
persistedFaceId |
string |
Сохраненный идентификатор лица добавленного лица, который сохраняется и не истечет. Отличается от faceId, который создается в "Detect" и истекает через 24 часа после вызова обнаружения. |
DetectionModel
Объект detectionModel, связанный с обнаруженными идентификаторами faceId. Поддерживаемые значения detectionModel включают detection_01, detection_02 и detection_03. Значение по умолчанию — "detection_01".
Имя | Тип | Описание |
---|---|---|
detection_01 |
string |
Модель обнаружения по умолчанию. Рекомендуется для обнаружения лиц, близких к лобовой области. В сценариях с исключительно большими углами (положением головы) лиц, заключаемых лиц или неправильной ориентации изображения лица в таких случаях могут не обнаруживаться. |
detection_02 |
string |
Модель обнаружения, выпущенная в мае 2019 года, с улучшенной точностью, особенно на небольших, боковых и размытых лицах. |
detection_03 |
string |
Модель обнаружения, выпущенная в феврале 2021 г. с улучшенной точностью, особенно на небольших лицах. |
FaceError
Объект error. Подробные сведения о кодах ошибок и сообщениях, возвращаемых службой распознавания лиц, см. по следующей ссылке: https://aka.ms/face-error-codes-and-messages.
Имя | Тип | Описание |
---|---|---|
code |
string |
Один из определяемого сервером набора кодов ошибок. |
message |
string |
Удобочитаемое представление ошибки. |
FaceErrorResponse
Ответ, содержащий сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
error |
Объект error. |