Головна / Посібники / Перевищено квоту Gemini API (429 RESOURCE_EXHAUSTED)

Перевищено квоту Gemini API (429 RESOURCE_EXHAUSTED)

Gemini API повертає 429 RESOURCE_EXHAUSTED, коли ви перевищуєте ліміт частоти або добову квоту. На безкоштовному тарифі ліміти малі. Ця сторінка пояснює кожну форму помилки, поточні безкоштовні ліміти і виправлення, які працюють.

Код, назви моделей і мітки живого каталогу показано англійською.

Як виглядає помилка

Типова помилка безкоштовного тарифу, опублікована на форумі розробників Google, має такі частини:

Приклад 429 з безкоштовного тарифу

429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.
Quota exceeded for metric: generativelanguage.googleapis.com/generate_content_free_tier_requests, limit: 50
quotaId: GenerateRequestsPerDayPerProjectPerModel-FreeTier
Please retry in 11.615098148s.
  • quotaMetric показує, що вичерпалося. generate_content_free_tier_requests рахує запити на безкоштовному тарифі.
  • quotaId показує вікно. PerDay є добовою квотою. Ідентифікатор PerMinute є лімітом на хвилину.
  • limit це ваша квота для цієї моделі в цьому вікні.
  • Please retry in дає час очікування, який пропонує Google.

Три коди 429 і один 403

Сторінка помилок API Google перелічує три коди помилок з HTTP 429 і пов'язаний з ними 403:

З сторінки помилок Gemini API
КодHTTPЗначенняРішення
rate_limit_exceeded429Досягнуто ліміту запитів або токенів на хвилину чи секундуПовторіть з експоненційною затримкою
quota_exceeded429Добову квоту вичерпаноДочекайтеся скидання або запросіть збільшення
too_many_requests429Забагато запитів за короткий проміжок часуПовторіть з експоненційною затримкою
permission_denied403Проєкт обмежено, або безкоштовний тариф для нього недоступнийПрив'яжіть платний обліковий запис і використовуйте платний тариф

Ліміт на хвилину спливає менш ніж за хвилину. Добова квота спливає лише під час скидання. Google скидає запити на добу о півночі за тихоокеанським часом. Повторна спроба з помилкою добової квоти до скидання марнує запити.

Безкоштовні ліміти тарифу сьогодні

Google застосовує ліміти до кожного проєкту Google Cloud, а не до кожного ключа. Ліміти різні для кожної моделі. Google показує ваші активні ліміти в AI Studio. Таблиця показує безкоштовні ліміти Gemini і Gemma з каталогу FreeLLMAPI.

Безкоштовні ліміти Gemini і Gemma з актуального каталогу
МодельБезкоштовно наКонтекстБезкоштовні ліміти (найкращі)ІнструментиЗображення
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaТакТак
Gemini Flash (latest alias)Google AI Studio-10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.7 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.6 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.5 FlashGoogle AI Studio1M10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.8 LiveGoogle AI Studio-10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini 3.8 Flash TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyНіНі
Gemini 3.8 Flash-Lite TTSGoogle AI Studio-Ongoing AI Studio free-tier quota; account limits applyНіНі
Gemini Robotics-ER 2 PreviewGoogle AI Studio131K10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
НіТак
Gemini 3.5 Flash LiteGoogle AI Studio1M15 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Gemini Flash Lite (latest alias)Google AI Studio-10 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак

Показано 12 із 21 відповідних безкоштовних моделей. Переглянути всі моделі.

Дані в реальному часі з каталогу FreeLLMAPI (версія 2026.11.19, перевірено 2026-11-19). Безкоштовні ліміти часто змінюються. Каталог перевіряється щодня.

Більшість моделей Flash дозволяють близько 20 запитів на добу на безкоштовному тарифі. Моделі Gemma дозволяють значно більше запитів на добу, але мають менше вікно контексту. Google каже, що зазначені ліміти не гарантуються і фактична потужність може відрізнятися.

Виправлення, які працюють

  1. Прочитайте quotaId. Якщо він містить PerDay, зупиніться і дочекайтеся скидання о півночі за тихоокеанським часом.
  2. Для ліміту на хвилину повторюйте з експоненційною затримкою і джитером. Задайте максимальну кількість повторів.
  3. Перенесіть прості завдання на модель з вищим добовим лімітом, наприклад на Gemma або Flash-Lite.
  4. Надсилайте менше токенів. Великі промпти швидко досягають ліміту токенів на хвилину.
  5. Не використовуйте дуже малий max_tokens. Gemini Flash може використовувати приховані токени міркування всередині ліміту виводу.
Що ви пробуєтеЧи допомагає?Чому
Створити новий ключ API в тому самому проєктіНіЛіміти діють для проєкту. Google каже, що новий ключ не усуває помилку.
Перевести проєкт на платний тарифДає платну квотуGoogle каже, що платний тариф не дає квоти безкоштовного тарифу. Платне використання тарифікується.
Дочекатися часу retry inТак, для лімітів на хвилинуВікно на хвилину оновлюється
Перейти на іншу модельТакКожна модель має власну квоту

Перевіряйте квоту перед надсиланням

Проблему можна побачити до помилки. В AI Studio відкрийте сторінку лімітів частоти з документації Gemini API. Вона показує активні ліміти вашого проєкту для кожної моделі. Сторінка Projects показує ваш тариф.

Якщо ви використовуєте FreeLLMAPI, запитайте у шлюзу, які моделі готові зараз. Модель зі статусом exhausted має ключі, які всі перебувають на охолодженні. Цей статус знімається сам, коли закінчуються періоди охолодження.

Список моделей, які можуть відповісти зараз

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Плануйте щоденне використання простими числами. За 20 запитів на добу одна модель Flash дає близько одного запиту кожні 72 хвилини протягом повного дня. Агент програмування може використати 20 запитів на одне завдання. Ставте моделі Flash лише на складні завдання, а прості надсилайте моделям з більшими добовими лімітами.

Перехід на резерв до інших безкоштовних постачальників

При близько 20 запитах Flash на добу одного ключа Gemini недостатньо для роботи агента. FreeLLMAPI ставить Gemini за одну кінцеву точку з іншими безкоштовними постачальниками. Коли Gemini надсилає 429, маршрутизатор надсилає запит наступній моделі у вашому ланцюгу.

  • Маршрутизатор рахує RPM, RPD, TPM і TPD для кожної моделі та ключа. Він зупиняється до досягнення відомого ліміту.
  • Короткий 429 ставить ключ на охолодження на 90 секунд. Вичерпана добова квота має довше охолодження: 2 хвилини, 10 хвилин, 1 годину, потім 24 години.
  • Якщо Google дає довший час очікування, маршрутизатор використовує значення Google.
  • Заголовок X-Fallback-Trail перелічує кожен невдалий перехід, наприклад google/gemini-2.5-flash key1=rate_limited.

Надсилайте трафік Gemini через шлюз

curl -fsSL https://freellmapi.co/install.sh | bash

curl -i http://localhost:3001/v1/chat/completions \
  -H "Authorization: Bearer <unified-key>" \
  -H "Content-Type: application/json" \
  -d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'

Gemini CLI також може використовувати нативну поверхню /v1beta шлюзу. Шлюз не додає квоти Gemini. Він використовує інших постачальників, коли Gemini досяг ліміту.

Відомі особливості Gemini

ПостачальникВідома проблемаЩо робити
Google AI StudioThinking tokens use output capGemini Flash can spend hidden thinking tokens inside maxOutputTokens. Avoid tiny max_tokens values or set thinkingBudget to 0 when provider support is available.

Дані в реальному часі з каталогу FreeLLMAPI (версія 2026.11.19, перевірено 2026-11-19). Безкоштовні ліміти часто змінюються. Каталог перевіряється щодня.

Використовуйте кожну з цих моделей через один ключ. FreeLLMAPI це маршрутизатор з відкритим кодом, який ви розгортаєте самі. Він об'єднує всі ці безкоштовні тарифи за однією кінцевою точкою, сумісною з OpenAI, і переходить до наступного, коли один з них досягає ліміту. Переглянути каталог або або почніть роботу.

Часті запитання

Що означає 429 RESOURCE_EXHAUSTED в Gemini API?

Це означає, що ваш проєкт перевищив ліміт частоти або квоту. quotaId у тілі помилки показує, чи це ліміт на хвилину, чи добова квота.

Коли скидається квота безкоштовного тарифу Gemini?

Запити на добу скидаються о півночі за тихоокеанським часом. Ліміти на хвилину скидаються протягом однієї хвилини.

Чому новий ключ API Gemini не усуває помилку квоти?

Google застосовує ліміти до проєкту Google Cloud, а не до ключа. Кожен ключ у тому самому проєкті ділить одну квоту.

Що означає limit: 0 у помилці квоти Gemini?

Це означає, що ваш проєкт не має безкоштовної квоти для цієї моделі в цьому вікні. Деякі проєкти не мають права на безкоштовний тариф. Перевірте ліміти в AI Studio або спробуйте іншу модель.

Як уникнути помилок 429 Gemini в агенті програмування?

Використовуйте кількох безкоштовних постачальників за одним шлюзом. Коли Gemini досягає ліміту, шлюз надсилає запит іншому постачальнику, і агент продовжує роботу.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі