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

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

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

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

bash

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
  }'

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

querystringобязательный

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

timeRangestringнеобязательный

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

safebooleanнеобязательный

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

numnumberнеобязательный

Сколько изображений вернуть: 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 }
}

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

imgSrcstringнеобязательный

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

thumbnailstringнеобязательный

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

sourceUrlstringнеобязательный

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

resolutionstringнеобязательный

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

formatstringнеобязательный

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

sourcestringнеобязательный

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

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