Начало работы

Быстрый старт

Сделайте первый запрос к API srezai.ru за пару минут: поставьте SDK, передайте ключ и получите чистые результаты поиска.

1. Получите API-ключ#

Войдите в личный кабинет и создайте ключ в разделе «API-ключи». Ключ показывается один раз при создании — сохраните его. Все ключи начинаются с префикса srz_live_. Подробнее — в разделе Аутентификация.

При регистрации — бонус

Новым аккаунтам начисляется 100 ₽ на счёт — это около 1 000 запросов на знакомство с API. Месячных квот нет: платите только за фактически выполненные запросы. Первый ключ создаётся автоматически при завершении знакомства, а попробовать поиск руками можно после входа в личном кабинете — программный API /api/v1/* всегда требует ключ.

2. Установите SDK#

Официальные клиенты берут на себя заголовки, разбор ошибок и повторы при лимитах. Ставить их не обязательно — API это обычный REST, и пример на cURL ниже работает без установки.

pip install srezai

3. Первый запрос#

Обязательное поле одно — query. Остальное необязательно: category сужает выдачу до новостей, IT или научных публикаций, language и timeRange — до языка и свежести.

from srezai import SrezAI

# Ключ можно не передавать: подхватится из SREZAI_API_KEY
client = SrezAI(api_key="srz_live_ВАШ_КЛЮЧ")

res = client.search("новости искусственного интеллекта", category="news")
for r in res["results"]:
    print(r["title"], "—", r["url"])

4. Разберите ответ#

Ответ приходит в JSON: массив results с чистыми результатами, подсказки, прямые ответы и метаданные meta с временем и количеством результатов.

json

{
  "query": "новости искусственного интеллекта",
  "results": [
    {
      "title": "…",
      "url": "https://…",
      "content": "Краткое описание страницы…",
      "engine": "yandex",
      "source": "example.ru",
      "score": 1.42,
      "relevance": 0.87,
      "publishedDate": "2026-07-21T09:00:00"
    }
  ],
  "answers": [],
  "suggestions": ["…"],
  "meta": { "total": 12, "tookMs": 640, "rawBytes": 84210, "cleanBytes": 5120 }
}

Что дальше#

Веб-поиск — все параметры и категории.
Поиск изображений — мультимодальные данные.
Чтение страницы — текст по ссылке в чистом markdown.
Скриншот страницы — рендер и вёрстка страницы.
DeepResearch — агентные исследования.
MCP-сервер — подключение к ИИ-агентам.

SDK и исходники#

Клиенты для Python и JavaScript лежат в одном репозитории srezai-sdk под лицензией MIT: семь методов API, отдельный класс исключения на каждую ошибку и повторы там, где они осмысленны. Пакеты — PyPI и npm.