О сервисе компьютерного зрения

Сервис компьютерного зрения Yandex Vision анализирует переданное изображение и возвращает вам результат.

Возможности для анализа

Возможности — это различные типы анализа, которые позволяет выполнять сервис. Например:

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

Тело запроса состоит из спецификаций (analyzeSpecs). В каждой спецификации вы передаете файл с изображением (content) и список возможностей (features), которые необходимо применить.

Например, чтобы попросить сервис обнаружить лица и распознать текст на изображении, тело запроса будет выглядеть так:

{
    "folderId": "b1gvmob95yysaplct532",
    "analyze_specs": [{
        "content": "iVBORw0KGgo...",
        "features": [{
            "type": "FACE_DETECTION"
        },
        {
            "type": "TEXT_DETECTION",
            "text_detection_config": {
                "language_codes": ["ru", "en"]
            }
        }]
    }]
}

В запросе можно передать до 8 спецификаций и использовать до 8 возможностей в каждой спецификации. Если вам надо использовать больше 8 возможностей для одного изображения, передайте его дважды в разных спецификациях.

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

Сервис возвращает массив результатов анализа для каждой из переданных спецификаций. Каждый элемент массива - это тоже массив результатов для каждой из запрошенных возможностей:

{
  "results": [{
    // Результаты для первой спецификации.
    "results": [{
        // Результаты для первой запрошенной возможности — обнаружение лиц.
        "faceDetection": { ... }
      },
      {
        // Результаты для второй запрошенной возможности — распознавание текста.
        "textDetection": { ... }
      }
    ]
  }]
}

Результаты в ответе сервиса возвращаются в том же порядке, в котором они были указаны в запросе. Если вы передали 2 спецификации: в первой изображение с котиками, а во второй — с собаками, то первым элементом в массиве будет результат для изображения с котиками.

Результаты для каждой запрошенной возможности также возвращаются

Если в процессе какого-то из анализов произошла ошибка, она будет возвращена вместо соответствующего результата. Подробнее об обработке ошибок.

Что дальше