Gemini quota exceeded

What engineers usually see

  • Google Gemini returns quota exceeded error
  • Could be hitting QPM (queries per minute) or daily quota
  • No indication of current quota usage
  • Cannot predict when quota resets

Why this is hard to debug

Gemini quotas are project-level and not exposed in API responses. You can't tell which quota was exceeded or how close you are to limits. Receipts track quota usage patterns.

Minimal repro

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_GOOGLE_KEY",
    base_url="https://aibadgr.com/v1"
)

response = client.chat.completions.create(
    model="gemini-1.5-flash",
    messages=[{"role": "user", "content": "test"}]
)

This request routes through AI Badgr and returns a stable request ID that links to an execution record.

Note: AI Badgr is OpenAI-compatible and works as a drop-in proxy. No SDK changes required — only the base_url changes.

What a per-request execution record makes visible

  • Quota type exceeded (QPM, daily, etc)
  • Current usage vs quota limit
  • Quota reset schedule
  • Historical quota usage trends
  • Recommended request pacing

Run 1 request → get receipt

Change your base URL to https://aibadgr.com/v1 and run your request.

The response includes an X-Badgr-Request-Id header that links to a receipt showing latency, retries, tokens, cost, and failure stage for that specific execution.

Not the engineer?
Share this page with your dev and ask them to run one request through AI Badgr. That's all that's needed to get the receipt.

This kind of thing only makes sense when you can actually see what happened to a single request from start to finish, instead of trying to piece it together from scattered logs.