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

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

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

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

Burstантифлуднеобязательный

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

Суточная квота24 чнеобязательный

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

Три счётчика: обращения, операции, кредиты

Квота считает обращения к API: один HTTP-запрос к /api/v1/* или один вызов инструмента MCP. Батч - это одно обращение и много операций: пять ссылок в одном read_urls дают одну единицу квоты, но пять строк в журнале и пять списаний. Поэтому число запросов в журнале и остаток квоты не совпадают - остаток всегда виден в get_usage и в заголовке X-RateLimit-Remaining.
Деньги - третий, независимый счётчик: списание идёт в кредитах по прайсу услуги (поиск и чтение - 1 кредит, извлечение - 2, проверка факта - 8, answer_search - 3/5/10, DeepSearch - 20 + 3 за 1000 токенов ответа). Поэтому 30 обращений за сутки могут стоить и 30, и 130 кредитов. Точный расход по услугам за сутки и неделю отдаёт get_usage - им и сверяйте баланс.

Повышенные лимиты — подписка PRO

Значения выше - для бесплатного тарифа. Повышенные лимиты (50 обращений/10 с, 500 в сутки) даёт подписка PRO за 990 ₽ в месяц. Она не входит в пополнение баланса: пополнение покупает кредиты на запросы, подписка - скорость и суточный потолок. Включается кнопкой в кабинете, деньги списываются с баланса, дальше подписка продлевается сама, пока на балансе хватает 990 ₽; отключить можно там же. Текущие лимиты всегда видно в кабинете и в ответе get_usage.

Пакет скорости: поднять потолок на срок

Подписка - не единственный способ. Если суточный потолок нужен не постоянно, а чтобы разгрести задачу, в кабинете продаются разовые пакеты: Пакет «Неделя» - 1000 обращений в сутки на 7 дней за 390 ₽; Пакет «Месяц» - 2000 обращений в сутки на 30 дней за 1490 ₽; Компаниям - 5000 обращений в сутки на 30 дней за 9900 ₽. Они списываются с баланса и не продлеваются сами. Пакет не отменяет тариф: действует тот потолок, который выше - потолок тарифа или пакета. Поэтому пакет можно купить и на бесплатном тарифе, и поверх PRO, ничего не теряя после его окончания: когда срок выйдет, вернётся потолок тарифа.

Запросы из кабинета и демо на главной

В личном кабинете запросы выполняются от имени вошедшего пользователя, без ключа в теле запроса, и считаются по IP: 5 за 10 секунд, 20 в сутки. Это лимит интерфейса - для программной нагрузки используйте ключ, у него квота на порядок выше.

На главной странице без входа выполняется только один заранее заданный демонстрационный запрос - он показывает формат ответа. Произвольный запрос без сессии и без ключа возвращает 401 с reason: "auth": и в веб-интерфейсе, и в /api/v1/*, и на MCP-сервере. Первый ключ выдаётся автоматически при завершении знакомства после регистрации.

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

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

http

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

X-RateLimit-Limitnumberнеобязательный

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

X-RateLimit-Remainingnumberнеобязательный

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

X-RateLimit-Resetunix timestampнеобязательный

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

Ответ 429

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

json

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

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

json

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