API

Поиск изображений

Поиск картинок с прямыми ссылками на оригинал, превью и метаданными (разрешение, формат, источник). Готов для мультимодальных пайплайнов и подбора иллюстраций.

POSThttps://srezai.ru/api/v1/media

Пример запроса#

curl -X POST https://srezai.ru/api/v1/media \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer srz_live_ВАШ_КЛЮЧ" \
  -d '{
    "query": "северное сияние",
    "timeRange": "month",
    "num": 12,
    "safe": true
  }'

Параметры тела#

querystringrequired

Поисковый запрос. Пробелы схлопываются, обрезается до 300 символов.

timeRangestringoptional

Свежесть: "" (по умолчанию), day, week, month, year.

safebooleanoptional

Безопасный поиск. По умолчанию true. Передайте false, чтобы отключить фильтрацию.

numnumberoptional

Сколько изображений вернуть: 1–48. Без этого поля приходит полный набор (до 48). Значение вне диапазона — 400 с кодом bad_request. Цена от num не зависит: платится вызов.

Если картинки идут в контекст модели, num стоит задавать: 48 записей с метаданными — это десятки килобайт на запрос, в котором нужен был один логотип. У MCP-инструмента image_search по этой причине дефолт — 12.

Ответ#

json

{
  "query": "северное сияние",
  "images": [
    {
      "title": "Северное сияние над фьордом",
      "imgSrc": "https://example.ru/aurora.jpg",
      "thumbnail": "https://srezai.ru/image_proxy?…",
      "sourceUrl": "https://example.ru/photo/123",
      "resolution": "1920x1080",
      "format": "jpeg",
      "source": "example.ru",
      "engine": "duckduckgo images"
    }
  ],
  "unresponsiveEngines": [],
  "meta": { "total": 48, "tookMs": 720, "rawBytes": 51200 }
}

Поля изображения#

imgSrcstringoptional

Прямая ссылка на оригинал изображения.

thumbnailstringoptional

Превью. Может проходить через прокси srezai.ru и совпадать с оригиналом.

sourceUrlstringoptional

Страница, на которой найдено изображение.

resolutionstringoptional

Разрешение вида 1920x1080 или пустая строка, если неизвестно.

formatstringoptional

Формат файла: jpeg, png и т. п.

sourcestringoptional

Домен или имя источника; engine — движок, нашедший картинку.

До 48 изображений

В ответе приходит до 48 уникальных изображений (дубли по ссылке отфильтровываются) или столько, сколько запрошено в num. Возвращаются только записи с отображаемой ссылкой и заголовком.

Сбой движков — это не пустой результат

Если ни один поисковый движок не ответил, эндпоинт вернёт 503 с кодом search_unavailable, а не 200 с пустым images. Пустой массив с кодом 200 означает именно «по запросу ничего не нашлось». См. Ошибки.

Ограничения и заголовки лимитов те же, что и у веб-поиска — см. Лимиты и квоты.