What this error means
A 503 UNAVAILABLE is server-side: Gemini is briefly saturated. It is transient but clusters during peak hours.
How to fix it
- Retry after a short delay with backoff
- Fail over to a second model on repeated 503s
- Avoid hammering the same region during a spike
Example error message
{
"error": {
"code": 503,
"message": "The model is currently experiencing high demand. Spikes in demand are usually temporary.",
"status": "UNAVAILABLE"
}
}Frequently asked
Is a 503 my fault?
No. It is a temporary capacity issue on the provider; a retry or fallback usually succeeds within seconds.
More Google Gemini errors
| Code | Error | Affected teams / 30 days | |
|---|---|---|---|
| 429 | Gemini 429 — You exceeded your current quota | 120 | View |
| 400 | Gemini 400 — Function call missing a thought_signature | 42 | View |
| View all Google Gemini errors | |||
Route Google Gemini through Manifest
Live token usage, every model, and automatic fallback when Google Gemini rate-limits or fails.