TypeError: float() argument must be a string or a real number, not 'NoneType'
Ai citit header-ul retry-after cu headers.get(), dar răspunsul nu îl conținea, așa că float() a primit None. Folosește o valoare de rezervă: float(e.response.headers.get("retry-after") or 2 ** incercare), adică backoff exponențial când header-ul lipsește.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
headers.get("retry-after") întoarce None când header-ul nu există. float(None) nu are sens, iar Python spune exact asta: argumentul trebuie să fie text sau număr, nu NoneType.
În codul de retry pentru 429 sau 529, mulți presupun că API-ul trimite mereu retry-after. Nu e garantat: unele răspunsuri nu-l au, unele erori 5xx sau proxy-uri intermediare nu-l pun, iar la APIConnectionError nici nu există un răspuns. Codul merge la primele teste și cade exact în situația pe care trebuia s-o rezolve.
Linia indicată e conversia cu float(); afișează e.response.headers ca să vezi ce a venit.
De ce apare: cauzele frecvente
1Header lipsă, fără valoare de rezervă
asteptare = float(e.response.headers.get("retry-after"))asteptare = float(e.response.headers.get("retry-after") or 2 ** incercare)Când header-ul lipsește, folosești backoff exponențial: 1, 2, 4 secunde...
2Valoare implicită pusă greșit
asteptare = float(e.response.headers.get("retry-after", None))asteptare = float(e.response.headers.get("retry-after", 1))Al doilea argument al lui get e valoarea întoarsă când cheia lipsește; None nu ajută.
3Header citit la o eroare fără răspuns
except anthropic.APIError as e:
asteptare = float(e.response.headers.get("retry-after"))except anthropic.APIStatusError as e:
asteptare = float(e.response.headers.get("retry-after") or 1)
except anthropic.APIConnectionError:
asteptare = 2APIConnectionError nu are răspuns HTTP; o tratezi separat.
Repară eroarea, direct în pagină
Bucla de retry citește retry-after cu float(...), dar răspunsul 429 nu are acest header, iar programul cade cu TypeError: float() argument must be a string or a real number, not 'NoneType'. Folosește 2 ** incercare secunde când header-ul lipsește, afișează Aștept <n> s și reîncearcă.
import time
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(max_retries=0)
for incercare in range(4):
try:
r = client.messages.create(
model=MODEL,
max_tokens=100,
messages=[{"role": "user", "content": "Ce documente îmi trebuie pentru deschiderea unui cont?"}],
)
print(r.content[0].text)
break
except anthropic.RateLimitError as e:
asteptare = float(e.response.headers.get("retry-after"))
print("Aștept", asteptare, "s")
time.sleep(asteptare)Aștept 1.0 s Îți trebuie actul de identitate și, uneori, un document care arată sursa veniturilor.
Indiciu
float(e.response.headers.get("retry-after") or 2 ** incercare).
Reparația
import time
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(max_retries=0)
for incercare in range(4):
try:
r = client.messages.create(
model=MODEL,
max_tokens=100,
messages=[{"role": "user", "content": "Ce documente îmi trebuie pentru deschiderea unui cont?"}],
)
print(r.content[0].text)
break
except anthropic.RateLimitError as e:
asteptare = float(e.response.headers.get("retry-after") or 2 ** incercare)
print("Aștept", asteptare, "s")
time.sleep(asteptare)De ce merge
headers.get întoarce None când header-ul lipsește, iar float(None) nu e permis. Operatorul or alege valoarea de rezervă când rezultatul e None: 2 ** incercare dă 1 secundă la prima încercare, apoi 2, apoi 4. Așa bucla funcționează și cu, și fără retry-after, iar cererea reușește la a doua încercare.
Alte forme ale mesajului
TypeError: int() argument must be a string, a bytes-like object or a real number, not 'NoneType'TypeError: 'NoneType' object cannot be interpreted as an integer
Cum o eviți pe viitor
- Pune mereu o valoare de rezervă când citești un header:
get(...) or valoare. - Pune o limită maximă pentru așteptare și pentru numărul de încercări.
- Lasă SDK-ul să facă retry-urile (
max_retries); el respectăretry-afterși folosește backoff când lipsește. - Testează ramura de retry cu erori simulate, cu și fără header.
Întrebări frecvente
Ce înseamnă backoff exponențial?
Aștepți tot mai mult după fiecare eșec: 1 s, 2 s, 4 s, 8 s. Adaugă și puțină variație aleatoare (jitter), ca mai mulți clienți să nu reîncerce în aceeași secundă.
De ce int(None) are alt mesaj?
Fiecare funcție are mesajul ei, dar cauza e aceeași: valoarea citită lipsea. Repari la fel, cu o valoare de rezervă.
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.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. 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.
