---
title: Лимиты
description: Лимиты RPM и параллельных генераций на ключ, заголовки RateLimit-* и обработка ответа 429.
---

Каждый API-ключ ограничен по умолчанию **120 запросами в минуту (RPM)** и **10 параллельными генерациями**; эти значения настраиваются. При превышении RPM запрос отклоняется с кодом `429 rate_limit_exceeded` и заголовком `Retry-After`, указывающим, через сколько секунд можно повторить.

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

<TypeTable
  type={{
    'RPM (запросов/мин)': {
      type: 'number',
      description: 'По умолчанию 120 на ключ. Настраивается. При превышении — 429 rate_limit_exceeded.',
    },
    'Параллельных генераций': {
      type: 'number',
      description: 'По умолчанию 10 одновременных генераций на ключ. Настраивается, не зависит от RPM.',
    },
  }}
/>

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

Заголовки `RateLimit-*` приходят на каждый ответ и позволяют отслеживать оставшийся бюджет, не дожидаясь `429`.

<TypeTable
  type={{
    'RateLimit-Limit': {
      type: 'integer',
      description: 'Текущий лимит RPM для ключа.',
    },
    'RateLimit-Remaining': {
      type: 'integer',
      description: 'Сколько запросов осталось в текущем окне.',
    },
    'RateLimit-Reset': {
      type: 'integer (секунды)',
      description: 'Через сколько секунд окно сбросится и счётчик обнулится.',
    },
    'Retry-After': {
      type: 'integer (секунды)',
      description: 'Присылается только при 429: через сколько секунд можно повторить.',
    },
  }}
/>

## Ответ 429

```http
HTTP/1.1 429 Too Many Requests
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 37
Retry-After: 37
```

```json
{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Превышен лимит запросов. Повторите позже."
  }
}
```

<Callout type="info" title="Соблюдайте Retry-After">
При `429` подождите ровно столько секунд, сколько указано в `Retry-After` (или `RateLimit-Reset`), и только потом повторяйте. Это надёжнее фиксированной задержки.
</Callout>

<Callout type="warn" title="Параллельность ограничена отдельно">
Лимит в 10 одновременных генераций не зависит от RPM. Если у вас много долгих видео-задач, ставьте их в очередь на своей стороне, чтобы не упереться в потолок параллельности.
</Callout>