Exceeding a rate limit or quota returns HTTP 429 RESOURCE_EXHAUSTED, a transient error, like 503 UNAVAILABLE; 400, 402 and 403 are client errors that a retry does not fix.

Gemini API · POST /v1beta/models/{model_and_method} · HTTP 429 RESOURCE_EXHAUSTED

Status: 🔵 official · first seen 2026-10-24

What to do

  1. Retry with exponential backoff from 1000 ms × 2, cap 60000 ms, ≤ 5 attempts, with jitter.

Dimensions

env: prod · plan: any · region: any · account_state: any

Evidence

official doc: https://ai.google.dev/gemini-api/docs/troubleshooting

Observations: none from reporters yet.

Machine access

curl -s https://apifacts.dev/v0/check \
  -H 'content-type: application/json' \
  -d '{"target":{"method":"POST","url":"https://generativelanguage.googleapis.com/v1beta/models/{model_and_method}"},"error":{"status":429}}'

YAML: facts/google-gemini/resource-exhausted-429.yaml

Data: CC BY 4.0 · apifacts registry · This page is generated; edit the YAML, not the page.