anthropic.InternalServerError: Error code: 529 - {'type': 'error', 'error': {'type': 'overloaded_error', 'message': 'Overloaded'}}
Serverele Anthropic sunt temporar suprasolicitate; nu e vina codului sau a contului tău. Reîncearcă după o pauză (SDK-ul o face automat de 2 ori), iar pentru aplicațiile importante pregătește un plan B: alt model sau alt furnizor, plus un mesaj prietenos pentru utilizator.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
529 nu e un cod HTTP standard; API-ul Claude îl folosește pentru „overloaded”: cererea ta e validă, dar în acel moment nu există capacitate s-o proceseze. Spre deosebire de 429, nu ține de limita contului tău, ci de încărcarea generală a serviciului, de obicei în perioade de vârf.
SDK-ul tratează 529 ca eroare temporară, la fel ca 5xx: reîncearcă automat (implicit de 2 ori, cu pauze crescătoare) și abia apoi aruncă anthropic.InternalServerError, cu status_code == 529. Dacă primești excepția, înseamnă că și reîncercările au eșuat.
În producție, reacția potrivită depinde de aplicație: pentru procesări în fundal, reîncerci mai târziu cu backoff; pentru un chatbot, comuți pe alt model sau pe alt furnizor (fallback) și, dacă nici acela nu merge, îi spui clientului politicos că asistentul revine în câteva minute. Mesajul tehnic „Overloaded” nu trebuie să ajungă la client.
De ce apare: cauzele frecvente
1Excepția 529 nu e tratată deloc
r = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)
return r.content[0].texttry:
r = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)
return r.content[0].text
except anthropic.InternalServerError:
return raspunde_cu_openai(mesaje)După reîncercările SDK-ului, aplicația trece pe un furnizor de rezervă în loc să cadă.
2Mesajul tehnic arătat clientului
except anthropic.APIStatusError as e:
return str(e) # "Error code: 529 - ... Overloaded"except anthropic.APIStatusError as e:
log.error("Eroare API %s: %s", e.status_code, e.message)
return "Asistentul nu este disponibil acum. Revino în câteva minute."Detaliile merg în log, pentru tine; clientul vede un mesaj pe care îl înțelege.
Repară eroarea, direct în pagină
Chatbotul de mai jos cade cu anthropic.InternalServerError: Error code: 529 ... Overloaded: în simulator, Claude rămâne suprasolicitat și după reîncercările automate. Repară funcția raspunde(mesaj): prinde anthropic.InternalServerError și trimite aceeași întrebare la OpenAI (gpt-6-luna, Responses API). Programul afișează Furnizor: ... și răspunsul.
import anthropic
from openai import OpenAI
MODEL = "claude-haiku-5-5"
MODEL_OPENAI = "gpt-6-luna"
SYSTEM = "Ești asistentul unei agenții de turism. Răspunzi scurt."
claude = anthropic.Anthropic()
oai = OpenAI()
def raspunde(mesaj):
r = claude.messages.create(model=MODEL, max_tokens=200, system=SYSTEM,
messages=[{"role": "user", "content": mesaj}])
return "anthropic", r.content[0].text
furnizor, text = raspunde("Ce acte îmi trebuie pentru o excursie în Turcia?")
print("Furnizor:", furnizor)
print(text)Furnizor: openai Pentru Turcia îți ajunge cartea de identitate sau pașaportul, valabile cel puțin 150 de zile.
Indiciu
În except, apelează oai.responses.create(model=MODEL_OPENAI, instructions=SYSTEM, input=mesaj) și întoarce output_text.
Reparația
import anthropic
from openai import OpenAI
MODEL = "claude-haiku-5-5"
MODEL_OPENAI = "gpt-6-luna"
SYSTEM = "Ești asistentul unei agenții de turism. Răspunzi scurt."
claude = anthropic.Anthropic()
oai = OpenAI()
def raspunde(mesaj):
try:
r = claude.messages.create(model=MODEL, max_tokens=200, system=SYSTEM,
messages=[{"role": "user", "content": mesaj}])
return "anthropic", r.content[0].text
except anthropic.InternalServerError:
r = oai.responses.create(model=MODEL_OPENAI, instructions=SYSTEM, input=mesaj)
return "openai", r.output_text
furnizor, text = raspunde("Ce acte îmi trebuie pentru o excursie în Turcia?")
print("Furnizor:", furnizor)
print(text)De ce merge
SDK-ul a reîncercat deja de două ori, deci excepția înseamnă că suprasolicitarea durează. În loc să cadă, aplicația trimite aceeași întrebare, cu aceleași instrucțiuni, la furnizorul de rezervă. Clientul primește un răspuns, iar tu vezi în log (aici, în Furnizor: openai) că s-a folosit planul B. Același tipar funcționează și cu un alt model Claude ca rezervă.
Alte forme ale mesajului
anthropic.InternalServerError: Error code: 529 - overloaded_error: Overloadedanthropic.InternalServerError: Error code: 500 - {'type': 'error', 'error': {'type': 'api_error', 'message': 'Internal server error'}}
Cum o eviți pe viitor
- Lasă reîncercările automate ale SDK-ului active pentru erorile temporare.
- Pentru chatboți, pregătește un fallback: alt model sau alt furnizor, cu același prompt.
- Procesările în fundal le pui într-o coadă care reîncearcă mai târziu, cu backoff.
- Urmărește pagina de status a furnizorului când vezi multe erori 529.
Întrebări frecvente
E vina mea? Am greșit ceva în cerere?
Nu. 529 înseamnă că serviciul e temporar supraîncărcat. Aceeași cerere va funcționa peste puțin timp.
Ce diferență e între 529 și 500?
500 (api_error) e o eroare internă neașteptată a serverului; 529 (overloaded_error) înseamnă lipsă de capacitate în acel moment. Pe amândouă le tratezi la fel: reîncercare cu pauză, apoi fallback.
Erori înrudite
anthropic.RateLimitError: Error code: 429 - rate_limit_error: Number of request tokens has exceeded your per-minute rate limit Ai trimis prea multe cereri sau prea mulți tokeni într-un minut pentru limita contului tău. Eroarea e temporară: așteaptă cât spune antetul `retry-after` și reîncearcă. Lasă SDK-ul să reîncerce (`max_retries`, implicit 2) sau scrie un backoff exponențial cu jitter, și rărește cererile. anthropic.APIConnectionError: Connection error. Cererea nu a ajuns la server sau răspunsul nu a ajuns înapoi: problemă de rețea, DNS, proxy, firewall sau o întrerupere scurtă. Verifică conexiunea și setările de proxy, lasă SDK-ul să reîncerce (`max_retries`) și prinde `APIConnectionError` cu un mesaj prietenos. anthropic.APITimeoutError: Request timed out. Răspunsul nu a venit în timpul permis de client (`timeout`). Apare la răspunsuri lungi, la un timeout setat prea mic sau la rețea lentă. Mărește `timeout`, păstrează reîncercările, folosește streaming pentru răspunsurile lungi și cere răspunsuri mai scurte. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
