Как исправить ошибку 429 в Gemini API
Проверьте квоту проекта и нагрузку до повторной отправки
Проблема
HTTP 429 означает ограничение запроса. В Gemini API квоты применяются к проекту, а не отдельному API-ключу. Несколько ключей одного проекта не увеличивают его квоту. Проверьте текст ошибки и лимиты RPM (запросы в минуту), TPM (токены в минуту) и RPD (запросы в день) для выбранной модели и уровня доступа.
Источник: официальные ограничения Gemini API. Для Vertex AI проверьте документацию именно используемого сервиса: причины 429 и правила квот могут отличаться.
Решение от api429.com
- Сохраните код ошибки, модель, время и идентификатор запроса без секретного ключа.
- Уменьшите параллелизм и размер запроса. При дневной квоте дождитесь сброса или измените квоту через провайдера.
- Для временного ограничения используйте задержку, учитывайте Retry-After, если он есть, и ограничьте число повторов. Добавьте случайный разброс задержек, чтобы воркеры не повторяли запросы одновременно.
- В API429 сначала проверьте доступ модели через GET /v1/models с вашим ключом. Маршрутизация может снизить число остановок, но не отменяет ограничения моделей и провайдеров.
Для генерации с оплатой или побочными эффектами не повторяйте запрос вслепую после таймаута: сначала проверьте статус созданной задачи. См. документацию API429.
Что вы получаете?
Контроль нагрузки
Ограничивайте число одновременных задач и следите за квотой выбранной модели.
Совместимый интерфейс
Для поддерживаемых запросов OpenAI SDK используйте base URL https://gateway.api429.com/v1 и ключ API429.
Проверяемая доступность
Каталог ключа и ответы API важнее общего обещания доступности. При устойчивой ошибке передайте идентификатор запроса поддержке.