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

Обнаружение лиц сейчас находится на стадии 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 ширина).

Что дальше

• Попробуйте обнаружить лица на изображении.
• Посмотрите, как обрабатывать ошибки.