Классификация изображений

Классификация изображений сейчас находится на стадии Preview.

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

Эта возможность позволяет оценить, насколько изображение соответствует какому-то признаку, например, есть ли на изображении контент для взрослых. Это сократит затраты на ручную модерацию: вы сможете блокировать такие изображения автоматически.

Список признаков, для которых возвращается результат, зависит от выбранной модели. Например, модель quality, оценивающая качество изображения, возвращает вероятности для признаков low, medium и high. Подробнее о доступных моделях.

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

Чтобы использовать эту возможность, укажите CLASSIFICATION в типе возможности и передайте название модели:

{
    "folderId": "b1gvmob95yysaplct532",
    "analyze_specs": [{
        "content": "iVBORw0KGgo...",
        "features": [{
            "type": "CLASSIFICATION",
            "classificationConfig": {
                "model": "quality"
            }
        }]
    }]
}

В рамках одной возможности для анализа может быть использована только одна модель. Если надо применить больше моделей к изображению, передайте еще один объект в features:

{
    "folderId": "b1gvmob95yysaplct532",
    "analyze_specs": [{
        "content": "iVBORw0KGgo...",
        "features": [{
            "type": "CLASSIFICATION",
            "classificationConfig": {
                "model": "quality"
            }
        },
        {
            "type": "CLASSIFICATION",
            "classificationConfig": {
                "model": "moderation"
            }
        }]
    }]
}

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

Сервис возвращает список признаков в формате:

{
    "name": "low", // имя признака
    "probability": 0,71257284 // вероятность соответствия признаку
}

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

Пример ответа:

{
  "results": [{
    "results": [{
      "faceDetection": {
        "properties": [{
            "name": "low",
            "probability": 0.001466292142868043
          },
          {
            "name": "medium",
            "probability": 0.003421348333358767
          },
          {
            "name": "high",
            "probability": 0.99511235952377319
          }
        ]
      }
    }]
  }]
}

Что дальше