Справочник

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

Каждый запрос к /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-лимиту, не считаются в суточную квоту.

Повышенные лимиты после пополнения

Значения выше — для аккаунтов на стартовом бонусе. После первого пополнения баланса лимиты повышаются автоматически (50 запросов/10 с, 500 в сутки) — без подписки и отдельной платы за тариф. Текущие лимиты всегда видно в кабинете и в ответе get_usage.

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

В личном кабинете запросы выполняются от имени вошедшего пользователя, без ключа в теле запроса, и считаются по 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-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
}