Лимиты

Лимиты складываются независимыми слоями; срабатывание любого из них возвращает 429 в одном формате:

HTTP/1.1 429 Too Many Requests
Retry-After: 41

{"code":"rate_limited","status":429,"retryable":true,
 "meta":{"policy":"write","limit":60,"window_seconds":60}}

Каждый ответ (не только 429) несёт текущее состояние:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1790000041

Всегда ориентируйтесь на Retry-After (в секундах) перед повтором — это единственный заголовок, гарантированно остающийся на весь v1. Лимиты считаются на аккаунт, по классу вызова (read/write/heavy — генерации), а не на ключ: выпуск новых ключей потолок не поднимает. Квоты тарифа (там, где они есть у продукта) при недоступности хранилища возвращают 503 service_unavailable вместо 429 — редкий случай, и только для трафика по API-ключу/OAuth, никогда для собственного веб-приложения продукта.

Далее: Ошибки · Идемпотентность