anthropic.BadRequestError: Error code: 400 - max_tokens: Input should be greater than or equal to 1
Ai trimis max_tokens cu valoarea 0 sau negativă. De obicei valoarea e calculată (buget rămas, limită minus tokeni folosiți) și a ajuns la zero. Verifică rezultatul înainte de apel: dacă bugetul e consumat, nu mai trimite cererea și spune asta utilizatorului.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
max_tokens este numărul maxim de tokeni pe care modelul îi poate genera în răspuns și trebuie să fie un număr întreg de cel puțin 1. Mesajul vine din validarea cererii: câmpul max_tokens are o valoare sub minimul permis.
Rar scrie cineva max_tokens=0 direct. Aproape mereu valoarea e calculată: bugetul zilnic al unui utilizator minus ce a consumat deja, limita contextului minus lungimea promptului, sau o valoare citită din configurare care a ajuns 0. Când bugetul se termină, scăderea dă 0 sau un număr negativ.
Eroarea e de fapt un semnal util: logica de buget a ajuns la capăt, iar aplicația trebuie să decidă ce face (refuză politicos, trece pe un model mai ieftin, așteaptă ziua următoare).
De ce apare: cauzele frecvente
1Buget rămas calculat fără verificare
rest = LIMITA_ZILNICA - consumat
r = client.messages.create(model=MODEL, max_tokens=rest, messages=mesaje)rest = LIMITA_ZILNICA - consumat
if rest <= 0:
return "Ai folosit bugetul de azi."
r = client.messages.create(model=MODEL, max_tokens=min(rest, 500), messages=mesaje)Când consumul atinge limita, rest devine 0 sau negativ. Verificarea înainte de apel înlocuiește eroarea API-ului cu un mesaj clar.
2Valoare din configurare lăsată pe 0
MAX_TOKENS = int(os.environ.get("MAX_TOKENS", "0"))MAX_TOKENS = int(os.environ.get("MAX_TOKENS", "500"))O valoare implicită 0 trece de int(), dar API-ul o respinge. Pune o valoare implicită utilizabilă.
Repară eroarea, direct în pagină
Fiecare utilizator are un buget de 1000 de tokeni pe zi, iar max_tokens se calculează din cât a rămas. Pentru ana, care a consumat tot, programul cade cu max_tokens: Input should be greater than or equal to 1. Repară raspunde: dacă bugetul rămas e 0 sau mai mic, întoarce Ai folosit bugetul de azi. Revino mâine. fără să apelezi API-ul; altfel folosește min(rest, 300).
import anthropic
MODEL = "claude-haiku-5-5"
LIMITA_ZILNICA = 1000
client = anthropic.Anthropic()
consumat = {"ana": 1000, "radu": 420}
def raspunde(utilizator, intrebare):
rest = LIMITA_ZILNICA - consumat[utilizator]
r = client.messages.create(model=MODEL, max_tokens=rest, messages=[{"role": "user", "content": intrebare}])
return r.content[0].text
for utilizator in ["ana", "radu"]:
print(utilizator, "->", raspunde(utilizator, "Unde găsesc factura?"))ana -> Ai folosit bugetul de azi. Revino mâine. radu -> Factura o găsești în cont, la secțiunea Comenzi, în format PDF.
Indiciu
Pune if rest <= 0: înainte de messages.create.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
LIMITA_ZILNICA = 1000
client = anthropic.Anthropic()
consumat = {"ana": 1000, "radu": 420}
def raspunde(utilizator, intrebare):
rest = LIMITA_ZILNICA - consumat[utilizator]
if rest <= 0:
return "Ai folosit bugetul de azi. Revino mâine."
r = client.messages.create(model=MODEL, max_tokens=min(rest, 300), messages=[{"role": "user", "content": intrebare}])
return r.content[0].text
for utilizator in ["ana", "radu"]:
print(utilizator, "->", raspunde(utilizator, "Unde găsesc factura?"))De ce merge
Pentru ana, 1000 - 1000 dă 0, iar API-ul respinge cererea pentru că modelul trebuie să poată genera măcar un token. Verificarea bugetului înainte de apel transformă eroarea într-un mesaj previzibil și economisește o cerere inutilă. min(rest, 300) păstrează și un plafon pe răspuns, ca un utilizator cu buget mare să nu primească răspunsuri nejustificat de lungi.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - {'type': 'error', 'error': {'type': 'invalid_request_error', 'message': 'max_tokens: Input should be greater than or equal to 1'}}anthropic.BadRequestError: Error code: 400 - max_tokens: Input should be a valid integer
Cum o eviți pe viitor
- Calculează
max_tokenscumin(rest, MAXIM)și verificărest > 0înainte de apel. - Ține bugetul în aplicație (tokeni consumați pe utilizator), nu te baza pe eroarea API-ului ca să afli că s-a terminat.
- Pentru valori din configurare, validează-le la pornirea aplicației.
Întrebări frecvente
Pot pune un max_tokens foarte mare ca să nu mai am grija lui?
Există și o limită superioară, specifică fiecărui model; peste ea primești altă eroare 400. În plus, max_tokens e plafonul tău de cost pe răspuns, deci pune o valoare pe măsura sarcinii.
Un max_tokens mic taie răspunsul?
Da. Dacă modelul atinge limita, răspunsul se oprește la mijloc și stop_reason este max_tokens. Verifică mereu stop_reason când contează să ai răspunsul complet.
Erori înrudite
anthropic.BadRequestError: Error code: 400 - max_tokens: 200000 > 128000, which is the maximum allowed number of output tokens for claude-haiku-5-5 Ai cerut un `max_tokens` mai mare decât poate genera modelul într-un răspuns. Pune o valoare sub limita modelului, pe măsura răspunsului de care ai nevoie (de exemplu 1000–4000 pentru texte obișnuite), și verifică `stop_reason` ca să știi dacă răspunsul a fost tăiat. TypeError: Missing required arguments; Expected either ('max_tokens', 'messages' and 'model') or ('max_tokens', 'messages', 'model' and 'stream') arguments to be given Apelul `client.messages.create(...)` nu are unul dintre parametrii obligatorii, de cele mai multe ori `max_tokens`. La API-ul Claude, `model`, `max_tokens` și `messages` sunt obligatorii: adaugă `max_tokens=500` (sau cât îți trebuie) în apel. json.decoder.JSONDecodeError: Unterminated string starting at: line 1 column 95 (char 94) JSON-ul de la model e tăiat la mijloc: răspunsul s-a oprit la `max_tokens` (`stop_reason == "max_tokens"`) înainte să închidă ghilimelele și acoladele. Mărește `max_tokens`, verifică `stop_reason` înainte de `json.loads` și cere câmpuri mai scurte. Î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.
