---
title: "rate_limit_exceeded — превышена частота запросов ключа"
url: https://lumean.app/developers/docs/errors/rate-limit-exceeded
locale: ru
description: "Запрос не выполнен. В теле — `reason: \"rate_limit_exceeded\"` (тот же код в `error_code`) и `retry_after` в секундах, в заголовках — `Retry-After` и `X-RateLimit-*`."
generated: 2026-10-18
---

# rate_limit_exceeded — превышена частота запросов ключа

- HTTP: `429`

- `reason`: `rate_limit_exceeded`

- Заголовок `Retry-After`: да

## Что произошло

Запрос не выполнен. В теле — `reason: "rate_limit_exceeded"` (тот же код в `error_code`) и `retry_after` в секундах, в заголовках — `Retry-After` и `X-RateLimit-*`.

## Почему

Ключ превысил одно из окон частоты `limits.requests.per_minute` / `per_hour` / `per_day`. Считаются запросы, а не объём работы: лёгкий и тяжёлый запрос весят одинаково. По умолчанию ключ по частоте не ограничен — окна задаются в настройках ключа.

## Что делать

Подождать `retry_after` секунд и повторить. Если упираетесь постоянно — снижайте частоту: опрос статуса заказа замените событиями realtime, между страницами каталогов делайте паузу.

## Следующий запрос

Тот же запрос через `retry_after` секунд. Действующие окна ключа видны в кабинете разработчика.

## Смежное

- [Гайд: лимиты и код 429](https://lumean.app/developers/docs/guide/limits)
- [Гайд: realtime вместо опроса](https://lumean.app/developers/docs/guide/realtime)
- [Кабинет: окна ключа](https://lumean.app/developers)

---

- Эта же страница в браузере: https://lumean.app/developers/docs/errors/rate-limit-exceeded
- Машинный справочник целиком: https://api.lumean.app/docs/llm.md