Rate limits

Лимиты запросов на рабочее пространство для каждого тарифа, отдельные окна для решений и чтения, заголовки X-RateLimit в каждом вызове, Retry-After при 429 и как снижать нагрузку.

Публичный API ограничивает, сколько запросов рабочее пространство может сделать в минуту. Лимит зависит от тарифа рабочего пространства:

ТарифЗапросов в минуту
Genesis60
Developer300
Growth2 000
Enterprise10 000

Страница API-ключи в приложении показывает ваш текущий лимит, а GET /v1/me возвращает его как plan.rate_limit_per_minute.

Как считается лимит

  • На рабочее пространство, а не на ключ. Все API-ключи рабочего пространства делят один бюджет; создание дополнительных ключей не добавляет пропускной способности.
  • У решений и чтения отдельные окна. POST /v1/decisions/{slug} считается в одном окне; endpoint'ы чтения — GET /v1/decisions, GET /v1/me и GET /v1/executions — в другом, с тем же лимитом в минуту, поэтому их опрос никогда не замедляет ваши решения. У вызовов URL вебхука решения есть собственное третье окно (тот же лимит, общий для вебхуков рабочего пространства), поэтому утёкший URL не может замедлить ваши API-ключи. Каждый запрос к MCP-серверу (initialize, tools/list, любой вызов инструмента) учитывается вместе с чтением, а run_decision — ещё и вместе с решениями. Вызовы вебхука с неверной подписью или секретом эти окна не затрагивают: у них свой бюджет — 30 в минуту на вебхук (затем 429).
  • Подпространства делят окна своего родителя. В режиме партнёра вызовы с заголовком Dcision-Workspace учитываются в окнах вашего рабочего пространства, какой бы ни был клиент.
  • Фиксированные окна в одну минуту. Окно открывается первым запросом и длится 60 секунд; следующий запрос после этого открывает новое.
  • Учитывается каждый аутентифицированный запрос — и успешные вызовы, и ошибки, и идемпотентные повторы. Запросы с недействительным ключом отклоняются до проверки лимита и не учитываются.

Заголовки

Каждый аутентифицированный ответ сообщает состояние своего окна — окна решений или окна чтения:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1791195060
ЗаголовокОписание
X-RateLimit-LimitСколько запросов разрешено вашему рабочему пространству за окно.
X-RateLimit-RemainingСколько запросов осталось в текущем окне.
X-RateLimit-ResetКогда заканчивается текущее окно, в секундах Unix.

Когда вы достигли лимита

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1791195060
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Slow down and retry after the reset time.",
    "request_id": "req_Tz6Kq1mW8vLp3Xc9Rn4D"
  }
}

Подождите Retry-After секунд, затем повторите. Запросы, отправленные раньше, продолжают завершаться ошибкой — и продолжают учитываться.

async function decide(slug, state) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const response = await fetch(`https://api.dcision.io/v1/decisions/${slug}`, {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify({ state }),
    });
    if (response.status !== 429) return response;
    const wait = Number(response.headers.get("Retry-After") ?? "1");
    await new Promise((resolve) => setTimeout(resolve, wait * 1000));
  }
  throw new Error("Still rate limited after 3 attempts");
}

Как оставаться в пределах лимита

  • Следите за X-RateLimit-Remaining и замедляйтесь, прежде чем он дойдёт до 0.
  • Сглаживайте всплески с помощью очереди или token bucket на своей стороне, а не отправляйте всё сразу.
  • Не распределяйте нагрузку по большему числу ключей — они делят бюджет рабочего пространства.
  • Нужно больше? Повысьте тариф или обсудите Enterprise с sales@dcision.io.

Лимиты Playground

У запусков в Playground свой потолок, отдельный от API: 30 запусков в минуту и 2 000 запусков в день на рабочее пространство. Сверх этого Playground отвечает 429 RATE_LIMITED; для больших объёмов используйте API-ключ.

Пропускная способность движка

У провайдера движка есть собственные лимиты на запросы и токены в секунду. На ключе движка Dcision их делят все рабочие пространства, поэтому Dcision сглаживает всплески: решение ждёт свободного слота в пределах своего timeoutMs, а не завершается ошибкой сразу. Если за это время слот не освобождается, вызов завершается ошибкой 503 ENGINE_RATE_LIMITED — это ошибка движка, которую можно повторять с backoff, а не 429 RATE_LIMITED вашего рабочего пространства. С вашим собственным ключом провайдера действуют лимиты вашего аккаунта у провайдера. См. Движки и BYOK.

На этой странице