OpenRouter weight_exceeds_budget: never retry; Sume queue_full

OpenRouter's weight_exceeds_budget 402 will not clear on retry; in_flight_budget_exhausted will. Sume splits the same way: queue_full retries, 402 does not.

4 min readSume
All posts

Do not retry weight_exceeds_budget. OpenRouter's limits page says this single request's estimated cost is larger than your whole budget, so retrying will not help: lower max_tokens or the prompt size, or add credits. Its sibling reason, in_flight_budget_exhausted, is transient and carries Retry-After. Sume draws the same line between 429 queue_full, which you retry, and 402 insufficient_credits, which you fix first.

Which OpenRouter 402 reasons are retryable?

Both come back as 402 with limit_source metadata, so the status code alone cannot decide. Facts below are from the page read 2026-10-01.

OpenRouter 402 reasons, from its limits page read 2026-10-01.
reasonlimit_sourceRetry?
in_flight_budget_exhaustedopenrouter_in_flight_budgetYes, after Retry-After
weight_exceeds_budgetopenrouter_creditsNo; shrink the request or add credits

Which Sume errors are retry-later?

429 queue_full means new paid generation submissions are refused because the workspace queue is full. Per Generation admission: wait for jobs to finish or cancel queued jobs, then retry with the same idempotency key. 429 rate_limited is request volume: back off using retry-after when present.

Which Sume errors are retry-never as-is?

402 insufficient_credits means the estimated cost cannot be reserved. The listed client behavior is to upgrade the plan, wait for included Gen$, or submit a cheaper request. 409 idempotency_conflict means a key was reused for a different payload: reuse keys only for exact retries.

How should a client sort them?

Keep one table keyed on the structured code, not the status. Retry with backoff on queue_full and rate_limited, always reusing the Idempotency-Key; the docs say not to retry unsafe submits without one. Surface 402 to a person or a cheaper-request path. For a 429 that carries no wait hint, see enforced spend limit 429 with no retry-after.

Sources

Related posts

More in Developers

All Developers posts

Written by Sume