NameError: name 'RateLimitError' is not defined
Ai scris except RateLimitError:, dar numele nu e importat: excepțiile SDK-ului stau în modul. Scrie except anthropic.RateLimitError: (sau openai.RateLimitError), ori importă explicit: from anthropic import RateLimitError.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Python evaluează expresia din except abia când apare o excepție. De aceea codul pare să meargă perfect la testare și cade exact când API-ul răspunde cu 429: atunci Python caută numele RateLimitError, nu-l găsește și ridică NameError, care ascunde eroarea inițială.
Excepțiile SDK-ului (RateLimitError, APIConnectionError, APIStatusError, AuthenticationError...) sunt definite în modulul anthropic, respectiv openai. Cu import anthropic le accesezi ca anthropic.RateLimitError; cu from anthropic import Anthropic ai importat doar clientul, nu și excepțiile.
În stivă vezi de obicei două erori: întâi RateLimitError, apoi „During handling of the above exception, another exception occurred” și NameError.
De ce apare: cauzele frecvente
1Excepția folosită fără prefixul modulului
import anthropic
...
except RateLimitError:import anthropic
...
except anthropic.RateLimitError:Cu import anthropic, toate numele din modul se scriu cu prefixul anthropic..
2Importat doar clientul
from anthropic import Anthropic
...
except RateLimitError:from anthropic import Anthropic, RateLimitError
...
except RateLimitError:Importul explicit aduce numele excepției în program.
3Excepția importată de la alt furnizor
import openai
client = anthropic.Anthropic()
...
except openai.RateLimitError:import anthropic
client = anthropic.Anthropic()
...
except anthropic.RateLimitError:Clientul Claude ridică anthropic.RateLimitError; openai.RateLimitError e altă clasă și nu o prinde.
Repară eroarea, direct în pagină
Programul reîncearcă cererea când API-ul răspunde cu 429, dar la prima limită atinsă cade cu NameError: name 'RateLimitError' is not defined. Repară ramura except ca să prindă excepția SDK-ului, să afișeze Limită atinsă, aștept <n> s cu valoarea din retry-after și să reîncerce.
import time
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(max_retries=0)
for incercare in range(3):
try:
r = client.messages.create(
model=MODEL,
max_tokens=100,
messages=[{"role": "user", "content": "Care e termenul de retur la un magazin online?"}],
)
print(r.content[0].text)
break
except RateLimitError as e:
asteptare = float(e.response.headers.get("retry-after"))
print("Limită atinsă, aștept", asteptare, "s")
time.sleep(asteptare)Limită atinsă, aștept 3.0 s Pentru cumpărăturile online ai 14 zile să returnezi produsul.
Indiciu
Clasa se află în modulul importat: anthropic.RateLimitError.
Reparația
import time
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(max_retries=0)
for incercare in range(3):
try:
r = client.messages.create(
model=MODEL,
max_tokens=100,
messages=[{"role": "user", "content": "Care e termenul de retur la un magazin online?"}],
)
print(r.content[0].text)
break
except anthropic.RateLimitError as e:
asteptare = float(e.response.headers.get("retry-after"))
print("Limită atinsă, aștept", asteptare, "s")
time.sleep(asteptare)De ce merge
RateLimitError este definită în modulul anthropic, iar programul a importat doar modulul, fără numele separat. Cu except anthropic.RateLimitError as e:, excepția ridicată de SDK e prinsă, iar e.response.headers.get("retry-after") spune cât să aștepți. A doua încercare reușește și programul afișează răspunsul.
Alte forme ale mesajului
NameError: name 'APIConnectionError' is not definedNameError: name 'APIStatusError' is not definedNameError: name 'anthropic' is not defined
Cum o eviți pe viitor
- Folosește
import anthropicși scrie excepțiile cu prefix:anthropic.RateLimitError. - Testează ramurile
except, de exemplu cu o eroare simulată (în curs,errorsdin scenariu). - Un linter (ruff, pyflakes) semnalează numele nedefinite înainte să rulezi programul.
- Prinde excepțiile specifice înaintea celor generale, ca fiecare caz să aibă tratamentul lui.
Întrebări frecvente
De ce eroarea apare doar uneori?
Pentru că linia din except se evaluează doar când apare o excepție. Cât timp API-ul răspunde normal, numele greșit nu e citit niciodată.
Pot prinde toate erorile API cu o singură excepție?
Da, anthropic.APIError le prinde pe toate, iar anthropic.APIStatusError doar pe cele cu cod HTTP. Prinde întâi excepțiile specifice (RateLimitError), apoi pe cele generale.
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. AttributeError: module 'openai' has no attribute 'error' Codul prinde excepțiile cu openai.error.RateLimitError, ca în SDK-ul vechi (0.x). În openai 1.0 și mai nou, modulul openai.error nu mai există: excepțiile sunt direct în pachet, de exemplu except openai.RateLimitError sau except openai.APIError. AttributeError: 'RateLimitError' object has no attribute 'status' Codul HTTP al unei erori de API se citește cu e.status_code, nu cu e.status. Excepțiile SDK-urilor anthropic și openai au status_code, message, body, response și request_id. Î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.
