...
Eroare Aplicații AI cu LLM · Parametri și mesaje respinse de API

anthropic.BadRequestError: Error code: 400 - max_tokens: Input should be greater than or equal to 1

Pe scurt

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

Greșit
PYTHON
rest = LIMITA_ZILNICA - consumat
r = client.messages.create(model=MODEL, max_tokens=rest, messages=mesaje)
Corect
PYTHON
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

Greșit
PYTHON
MAX_TOKENS = int(os.environ.get("MAX_TOKENS", "0"))
Corect
PYTHON
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ă tu

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

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

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_tokens cu min(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

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