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

TypeError: float() argument must be a string or a real number, not 'NoneType'

Pe scurt

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ă

Greșit
PYTHON
asteptare = float(e.response.headers.get("retry-after"))
Corect
PYTHON
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

Greșit
PYTHON
asteptare = float(e.response.headers.get("retry-after", None))
Corect
PYTHON
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

Greșit
PYTHON
except anthropic.APIError as e:
    asteptare = float(e.response.headers.get("retry-after"))
Corect
PYTHON
except anthropic.APIStatusError as e:
    asteptare = float(e.response.headers.get("retry-after") or 1)
except anthropic.APIConnectionError:
    asteptare = 2

APIConnectionError nu are răspuns HTTP; o tratezi separat.

Repară tu

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

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

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

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