Обнаружение лиц
Обнаружение лиц сейчас находится на стадии Preview.
В этом разделе описано, как работает возможность обнаружение лиц в сервисе.
Эта возможность позволяет находить лица людей на изображении. Например, чтобы отметить людей на фотографии или найти все фото с портретами.
Примечание
Эта возможность не умеет распознавать лица. Вы не сможете находить похожие лица или идентифицировать личность человека с ее помощью.
Формат запроса
В типе возможности укажите FACE_DETECTION
:
{
"folderId": "b1gvmob95yysaplct532",
"analyze_specs": [{
"content": "iVBORw0KGgo...",
"features": [{
"type": "FACE_DETECTION"
}]
}]
}
Ответ сервиса
Сервис ищет лица людей на изображении и выделяет их прямоугольниками. В ответе сервис возвращает координаты прямоугольников для всех найденных лиц:
Если два лица расположены рядом, то прямоугольники могут пересекаться.
Координаты прямоугольника считаются от левого верхнего угла и указываются против часовой стрелки:
1←4
↓ ↑
2→3
Пример ответа с координатами обнаруженного лица:
{
"results": [{
"results": [{
"faceDetection": {
"faces": [{
"boundingBox": {
"vertices": [{
"x": "410",
"y": "404"
},
{
"x": "410",
"y": "467"
},
{
"x": "559",
"y": "467"
},
{
"x": "559",
"y": "404"
}
]
}
}]
}
}]
}]
}
Требования к изображению
Изображение в запросе должно соответствовать следующим требованиям:
-
Поддерживаемые форматы файлов: JPEG, PNG, PDF.
MIME-тип файла вы указываете в свойстве
mime_type
. По умолчаниюimage
. -
Максимальный размер файла: 1 МБ.
-
Размер изображения не должен превышать 20 мегапикселей (длина x ширина).