OpenRouter error
OpenRouter 502 provider_unavailable: what it means and how to fix it
502 provider_unavailableRetry? Not statedLast verified 1 documented fix1 source
What it means
Your chosen model is down, or the upstream provider returned an invalid or empty response. OpenRouter may auto-retry with another provider if fallback routing is enabled.
Causes
- Chosen model is down
- Invalid or empty response from the upstream provider
- Provider disconnected mid-stream
How to fix it
- Fix 1.
Enable fallback routing or add fallback models so another provider can serve the request.
More OpenRouter errors
All 32 OpenRouter errors400 invalid_requestRetry? Not stated400 invalid_promptRetry? Not stated400 context_length_exceededRetry? Not stated400 max_tokens_exceededRetry? Not stated400 token_limit_exceededRetry? Not stated400 string_too_longRetry? Not stated400 invalid_imageRetry? Not stated400 image_too_largeRetry? Not stated
HTTP 502 at other providers
FAQ
What does the OpenRouter error "502 provider_unavailable" mean?
Your chosen model is down, or the upstream provider returned an invalid or empty response. OpenRouter may auto-retry with another provider if fallback routing is enabled.
How do I fix OpenRouter "502 provider_unavailable"?
Enable fallback routing or add fallback models so another provider can serve the request.
Should I retry OpenRouter "502 provider_unavailable"?
Not stated. The official docs do not say whether this error is retryable.
Which other AI APIs return HTTP 502?
Per their official error docs: Groq API (502 Bad Gateway), Mistral API (502 Bad gateway).
Sources
Last verified against 1 source: OpenRouter's official docs and official SDK repositories.
Newsletter
Know when the APIs change
One email per week. New model releases, API changes, what broke, and how developers are working around it.