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

NameError: name 'RateLimitError' is not defined

Pe scurt

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

Greșit
PYTHON
import anthropic
...
except RateLimitError:
Corect
PYTHON
import anthropic
...
except anthropic.RateLimitError:

Cu import anthropic, toate numele din modul se scriu cu prefixul anthropic..

2Importat doar clientul

Greșit
PYTHON
from anthropic import Anthropic
...
except RateLimitError:
Corect
PYTHON
from anthropic import Anthropic, RateLimitError
...
except RateLimitError:

Importul explicit aduce numele excepției în program.

3Excepția importată de la alt furnizor

Greșit
PYTHON
import openai
client = anthropic.Anthropic()
...
except openai.RateLimitError:
Corect
PYTHON
import anthropic
client = anthropic.Anthropic()
...
except anthropic.RateLimitError:

Clientul Claude ridică anthropic.RateLimitError; openai.RateLimitError e altă clasă și nu o prinde.

Repară tu

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.

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

Alte forme ale mesajului

  • NameError: name 'APIConnectionError' is not defined
  • NameError: name 'APIStatusError' is not defined
  • NameError: 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, errors din 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

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