REST API анализа изображения
Один запрос — три слоя разбора и готовое решение модерации с доказательствами: какая метка, какое выражение или какая категория сработала. Стоп-листы задаёт ваша площадка, глубину проверки — вы.
Быстрый старт
Подключите модерацию изображений за три шага
Отправьте картинку
POST /api/imagecheck с полем image —
Base64 или data-URL, до 7 МБ. JPEG, PNG, WEBP, BMP, GIF.
Выберите глубину
includeText включён по умолчанию,
includeWebSearch — по заказу. От набора зависят
и цена, и полнота.
Разведите потоки
allow — в ленту, review — модератору
с доказательствами, block — не публиковать.
Возможности API
Что приходит в ответе на один запрос
Готовое решение
decision — allow, review или block. Рекомендация, а не приговор.
Доказательства
flags — что сработало, каким слоем и с какой уликой.
Классификация
safeSearch — пять категорий со степенью уверенности.
Что изображено
labels — метки с уверенностью, частотные ещё и по-русски.
Текст на картинке
text — надписи целиком, с сохранением переносов.
Поиск в вебе
webSearch — где ещё встречается это изображение.
Счёт в ответе
billedUnits — сколько единиц списано фактически.
Swagger + CORS
Спецификация OpenAPI с примерами; удобно для браузерных инструментов.
Три слоя, которые не пересекаются
Это свойство контракта, а не реклама: каждый слой ловит то, чего два остальных не видят
| Слой и поле ответа | Что ловит | Что при этом молчит |
|---|---|---|
Содержимое
safeSearch |
Откровенное фото или сцену насилия — там, где нет ни надписей, ни узнаваемых предметов | Метки и текст: распознавать нечего, читать нечего |
Предметы
labels |
Шприц, оружие, игральные фишки, бутылку, сигарету | Классификация содержимого: в фотографии шприца нет ни наготы, ни насилия |
Текст
text |
Телефон продавца, баннер казино, объявление о документах, лозунг | ОБА предыдущих слоя: на картинке нет ни предмета, ни «взрослого» — там просто буквы |
includeText — запрещённое редко
фотографируют, его рекламируют, а реклама это надпись. Поэтому текстовый
слой включён по умолчанию, и отключать его стоит только осознанно.
Единицы работы: от 1 до 3
Цена зависит от набора слоёв, а не от числа запросов
Базовый слой
Метки предметов вместе с классификацией содержимого. Обязателен и не отключается.
Классификация выполняется в паре с метками и отдельной единицей не считается — дешевле проверки не бывает.
Текст на изображении
Параметр includeText, включён по умолчанию.
Отсутствие надписей на картинке — нормальный исход, и он тарифицируется: работа по чтению выполнена.
Поиск в вебе
Параметр includeWebSearch, выключен по умолчанию.
Списывается, ТОЛЬКО если поиск вернул совпадения: за пустой результат платить не нужно.
billedUnits,
так что расход можно сверить, не заглядывая в биллинг. Анализ, который
не выполнен, не тарифицируется вовсе.
Нужна помощь с интеграцией?
Используйте Swagger ниже и примеры параметров. В песочнице по демо-ключу ветку ответа задаёт размер изображения — так можно закрепить в тестах все четыре.
Swagger документация API
Откройте спецификацию OpenAPI, чтобы проверить запросы и ответы API анализа изображения.
Почему выбирают наш API
Преимущества REST API анализа изображения для интеграции
Три проверки одной интеграцией
Содержимое, предметы и надписи приходят вместе. Не нужно подключать три сервиса и сводить их ответы у себя.
Правила задаёте вы
Категории, словари и строгость — под вашу тематику и применяются без перезапуска. Новое слово добавляется в тот же день, когда модератор его увидел.
Решение можно проверить
Кроме вердикта приходят доказательства и сырые слои. В модерации ошибка стоит дорого в обе стороны, и решение, которое нельзя перепроверить, доверия не заслуживает.
Ничего лишнего с картинкой
Лица не распознаются, личность не устанавливается, изображения не сохраняются после анализа.
Готовы подключить модерацию?
Встройте проверку в загрузку изображений или посмотрите, как выглядит разбор, в GUI.