Home/Wiki Errors/Gemini CLI
Gemini CLI / Rate limits

429 Too Many Requests / quota exceeded - Gemini CLI

The Google account, project, API key, or model quota used by Gemini CLI has hit a rate or daily usage limit.

Gemini CLI 429 quota exceededGemini CLI rate limitGemini CLI RESOURCE_EXHAUSTED
Paste an error to match it against the wiki. / 粘贴报错后自动匹配。

Error text / 报错原文

  • 429 Too Many Requests
  • quota exceeded
  • RESOURCE_EXHAUSTED

What it means

The Google account, project, API key, or model quota used by Gemini CLI has hit a rate or daily usage limit.

Most common causes

  • Free-tier quota exhausted
  • Several IDEs or agents sharing one key
  • Large prompts and file context consuming tokens quickly
  • Retry loops after a transient failure

Fastest fix

  • Wait for the quota reset window
  • Switch to a project with available quota if policy allows
  • Reduce context and retry after backoff
  • Stop parallel agent sessions sharing the same key

Safe fix

  • Set per-project budgets and alerts
  • Use backoff in scripts
  • Separate automation keys from manual CLI usage
  • Track model and token usage by project

What not to do

  • Do not create throwaway accounts to evade quota
  • Do not put paid keys into public MCP configs
  • Do not run tight retry loops on 429

How to confirm the fix

Run the smallest reproducible command first, then retry the agent task only after authentication, quota, and tool discovery are stable.

gemini --version
echo $GEMINI_API_KEY
gcloud alpha services quota list --service=generativelanguage.googleapis.com

Related errors

Related tools

Sources