Yandex.Cloud
  • Сервисы
  • Почему Yandex.Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Yandex Vision
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Распознавание текста
    • Определение качества изображения
    • Модерирование изображений
    • Обнаружение лиц
    • Кодирование в Base64
  • Концепции
    • Обзор
    • Распознавание текста
      • Обзор
      • Распознавание шаблонов
      • Поддерживаемые языки
      • Ограничения в текущей версии
    • Классификация изображений
      • Обзор
      • Поддерживаемые модели
    • Обнаружение лиц
    • Квоты и лимиты
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC
      • Обзор
      • VisionService
    • REST
      • Обработка ошибок
      • Диагностика ошибок
      • Обзор
      • Vision
        • Обзор
        • batchAnalyze
  • Вопросы и ответы
  1. Концепции
  2. Обнаружение лиц

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

  • Формат запроса
  • Ответ сервиса
  • Требования к изображению

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

Что дальше

  • Попробуйте обнаружить лица на изображении
  • Посмотрите, как обрабатывать ошибки
В этой статье:
  • Формат запроса
  • Ответ сервиса
  • Требования к изображению
Language
Вакансии
Политика конфиденциальности
Условия использования
© 2021 ООО «Яндекс.Облако»