...
Eroare Aplicații AI cu LLM · Rate limit, suprasolicitare, timeout și retry

anthropic.InternalServerError: Error code: 529 - {'type': 'error', 'error': {'type': 'overloaded_error', 'message': 'Overloaded'}}

Pe scurt

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

Greșit
PYTHON
r = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)
return r.content[0].text
Corect
PYTHON
try:
    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

Greșit
PYTHON
except anthropic.APIStatusError as e:
    return str(e)   # "Error code: 529 - ... Overloaded"
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

Alte forme ale mesajului

  • anthropic.InternalServerError: Error code: 529 - overloaded_error: Overloaded
  • anthropic.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

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.