Справочник

Лимиты и квоты

Каждый запрос к /api/v1/* и MCP-серверу проходит двойную проверку: защита от флуда (burst) и суточная квота. Лимиты применяются к ключу (аккаунту), а не к IP — все запросы одного клиента считаются вместе.

Лимиты по ключу#

Программный API /api/v1/* и MCP-сервер работают только с ключом srz_live_…. Корзина лимита — ваш аккаунт, поэтому смена IP или числа серверов на лимит не влияет:

Burstантифлудoptional

10 запросов за 10 секунд. При превышении — 429 с reason: "burst" и временем ожидания в секундах.

Суточная квота24 чoptional

200 запросов в сутки (скользящее окно 24 часа). При исчерпании — 429 с reason: "quota".

Burst не тратит суточную квоту

Запросы, отклонённые по burst-лимиту, не считаются в суточную квоту.

Единый лимит на аккаунт

Значения выше — общий дефолт на время бета-периода. Персональные тарифные лимиты по плану появятся позже; следите за страницей Цены.

Пробный доступ без ключа#

Попробовать поиск без ключа можно в личном кабинете — там запросы проверяются по IP (5 за 10 секунд, 20 в сутки). Программный API и MCP без ключа отвечают 401.

Заголовки в ответе#

Каждый успешный ответ содержит три заголовка — можно читать их без разбора тела:

http

HTTP/2 200
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 197
X-RateLimit-Reset: 1753222800

X-RateLimit-Limitnumberoptional

Максимальное число запросов в текущем окне.

X-RateLimit-Remainingnumberoptional

Осталось запросов до сброса.

X-RateLimit-Resetunix timestampoptional

Unix-время (секунды) сброса счётчика.

Ответ 429#

При превышении burst-лимита сервер также возвращает заголовок Retry-After (секунды). Тело ответа:

json

{
  "error": "Слишком много запросов подряд. Секунду…",
  "reason": "burst",
  "retryAfterSec": 4
}

При исчерпании суточной квоты:

json

{
  "error": "Дневная квота ключа исчерпана.",
  "reason": "quota",
  "retryAfterSec": 43200
}