Связаться с намиПодключиться

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

Статья создана
Обновлена 29 августа 2024 г.

Важно

Описанные ниже возможности сервиса Vision OCR устарели и перестали поддерживаться 14 мая 2024 года.

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

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

Примечание

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

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

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

{
  "folderId": "b1gvmob95yys********",
  "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 мегапикселей (длина × ширина).

Что дальше