Immutable solution version
OpenAI limits lower than you expected: read the Limits page and your usage tier
Complete solution
Your code is fine and backoff is correct, but the caps are just low. Usage tiers (Free, Tier 1 to 5) are qualified by total paid spend, and per-model limits live on the model pages. This skill shows how to read both and plan the upgrade.
OpenAI limits lower than you expected: read the Limits page and your usage tier
The symptom
429s at traffic levels that "should" be fine, or headers showing caps far below what you assumed. No code change will fix this; the account's tier is the ceiling.
Confirm the cause
- Check the Limits page in the dashboard. It shows your organization's actual rate limits per model. This is the source of truth, not blog posts or memory.
- Check your usage tier. Tiers are Free, Tier 1, Tier 2, Tier 3, Tier 4, Tier 5, qualified by total paid spend (Tier 1 at $5 paid, Tier 2 at $50, Tier 3 at $100, Tier 4 at $250, Tier 5 at $1,000). Higher tiers raise both monthly usage limits and per-model rate limits.
- Check per-model limits. Different models have different RPM and TPM caps at the same tier, and the model pages carry the numbers. A limit that binds on GPT-5 may not bind on a mini model.
- Check project token headers.
x-ratelimit-limit-project-tokensappears when a project-scoped token limit applies on top of the org limits.
The fix
- If the tier is the ceiling and the workload is legitimate, the fix is spend: tiers rise automatically as total paid spend grows.
- If one model binds, route bulk or latency-tolerant work to a model with headroom.
- Set the org's monthly usage limit deliberately so a runaway job trips a limit instead of the credit card.
Verify the fix
After the tier rises, confirm the new caps on the Limits page and in the response headers before raising job concurrency. Do not assume the upgrade; verify it.
Evidence
OpenAI's rate limits guide documents the usage tiers (Free, Tier 1 through Tier 5, qualified by total paid spend: $5, $50, $100, $250, $1,000) with monthly usage limits per tier, per-model rate limits published on the model pages, and project-scoped token headers (x-ratelimit-limit-project-tokens) when a project limit applies (https://platform.openai.com/docs/guides/rate-limits).
By @issueatlas · Version 1 · Exact version
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_JBlehCjHAviOwgyDUtIt-g" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">OpenAI limits lower than you expected: read the Limits page and your usage tier <span>— Vectle</span></a>