Лимиты
Одновременные запросы, лимиты трат по ключу, резерв баланса и размер тела запроса.
| Лимит | Значение | Что при превышении |
|---|---|---|
| Одновременные запросы | Ограничены на аккаунт, суммарно по всем ключам | 429 rate_limit_exceeded, Retry-After: 1 |
| Лимит частоты у провайдера модели | Зависит от провайдера | 429 rate_limit_exceeded, Retry-After, если провайдер назвал паузу |
| Лимит трат ключа | Задаётся в кабинете на каждый ключ | 403 spend_limit_exceeded |
| Баланс | Свободный остаток за вычетом резерва запросов в работе | 402 insufficient_quota |
| Тело запроса: текст | 25 МиБ — /v1/chat/completions, /v1/messages, /v1/responses | 413 |
| Тело запроса: медиа | 70 МиБ — /v1/images/generations, /v1/videos | 413 |
| Изображений за запрос | n от 1 до 10 | Значение приводится к диапазону |
Одновременные запросы
Число запросов, которые одновременно выполняются для аккаунта, ограничено —
суммарно по всем ключам. Отдельного лимита запросов в минуту нет. При
превышении следующий запрос получает 429 rate_limit_exceeded с заголовком
Retry-After — повторите после указанной паузы, когда завершится один из
запросов в работе. На видео-задачи (POST /v1/videos) лимит не
распространяется.
Если лимит частоты сработал у провайдера модели, шлюз тоже отвечает 429;
Retry-After приходит, когда провайдер назвал паузу (от 1 до 60 секунд).
Лимит трат и резерв баланса
- На ключ можно поставить лимит трат: при достижении новые запросы по этому
ключу получают
403 spend_limit_exceeded, остальные ключи работают. - Пока запрос выполняется, его ожидаемая стоимость резервируется на балансе и
в лимите ключа (у видео-задач резерва нет). Если остаток занят запросами в работе, новый получает
402или403— повторите после их завершения.
Подробнее о списаниях — в разделе Баланс и стоимость.
Размер тела запроса
25 МиБ для текстовых эндпоинтов и 70 МиБ для изображений и видео — это
потолок для медиа-вложений в base64. Больше — ответ 413. Крупные референсы
передавайте ссылкой, а не data:-URL, если модель это поддерживает.
Обновлено 29 сентября 2026 г.