Обнаружение лиц

Обнаружение лиц сейчас находится на стадии Preview.

В этом разделе описано, как работает возможность обнаружение лиц в сервисе.

Эта возможность позволяет находить лица людей на изображении. Например, чтобы отметить людей на фотографии или найти все фото с портретами.

Примечание

Эта возможность не умеет распознавать лица. Вы не сможете находить похожие лица или идентифицировать личность человека с ее помощью.

Формат запроса

В типе возможности укажите FACE_DETECTION:

{
    "folderId": "b1gvmob95yysaplct532",
    "analyze_specs": [{
        "content": "iVBORw0KGgo...",
        "features": [{
            "type": "FACE_DETECTION"
        }]
    }]
}

Ответ сервиса

Сервис ищет лица людей на изображении и выделяет их прямоугольниками. В ответе сервис возвращает координаты прямоугольников для всех найденных лиц:

image

Если два лица расположены рядом, то прямоугольники могут пересекаться.

Координаты прямоугольника считаются от левого верхнего угла и указываются против часовой стрелки:

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 ширина).

Что дальше