API429 / API errors

AI API errors and how to fix them

Claude, GPT, Gemini and DeepSeek error codes explained from the official documentation: what the response means, whether to retry, and what to do when the provider is unavailable in your country or the balance is exhausted.

ErrorType
429 Too Many Requests in AI APIsHTTP · HTTP 429 · Too Many RequestsRate limit
Gemini API: 503 UNAVAILABLEGoogle Gemini · HTTP 503 · UNAVAILABLEProvider overload
Gemini API: location not supportedGoogle Gemini · HTTP 400 · FAILED_PRECONDITIONUnsupported region
Claude API: 429 rate_limit_errorAnthropic Claude · HTTP 429 · rate_limit_errorRate limit
Claude API: 529 overloaded_errorAnthropic Claude · HTTP 529 · overloaded_errorProvider overload
Claude API: country not supportedAnthropic Claude · HTTP 403 · permission_errorUnsupported region
OpenAI API: 429 insufficient_quotaOpenAI · HTTP 429 · insufficient_quotaOut of balance or quota
OpenAI API: country not supported (403)OpenAI · HTTP 403 · unsupported_country_region_territoryUnsupported region
DeepSeek API: 402 Insufficient BalanceDeepSeek · HTTP 402 · Insufficient BalanceOut of balance or quota

How to read an error

Retry only transient errors — 429 with Retry-After, 500, 503 and 529 — with a capped number of attempts and a growing delay. Region errors (403, FAILED_PRECONDITION) and exhausted balance (insufficient_quota, 402) are not fixed by retrying.

Through API429, Claude, GPT, Gemini, Grok and DeepSeek share one OpenAI-compatible key: when one model is overloaded you can send the request to another by changing only the model field.

Payment and a $10 test

  • Russian bank card. Top up your balance in the account.
  • Invoice for companies. Bank transfer with closing documents.
  • USDT and TON. Top up in crypto.

$10 test credit. Subscribe to our Telegram channel through the bot and get $10 on your balance for the first requests. Get $10 in the bot

Telegram