anthropic.BadRequestError: Error code: 400 - output_config.effort: Input should be 'low', 'medium', 'high', 'xhigh' or 'max'
Ai dat parametrului effort o valoare pe care API-ul Claude nu o acceptă (de exemplu "minimal", "Low" sau "mic"). Valorile permise sunt exact "low", "medium", "high", "xhigh" și "max", scrise cu litere mici, în output_config={"effort": "low"}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
output_config.effort stabilește cât efort depune modelul pe răspuns: la low e mai rapid și mai ieftin, la high, xhigh și max lucrează mai mult la sarcinile grele. Validarea e strictă: API-ul acceptă doar cele cinci valori din mesaj, ca text, cu litere mici.
Calea din mesaj, output_config.effort, îți arată exact câmpul respins. Cauzele obișnuite: o valoare luată din alt API ("minimal", folosit la unele modele OpenAI), majuscule ("Low"), o traducere ("mic") sau un număr (1). Eroarea e un 400, deci cererea nu a fost procesată și nu s-au consumat tokeni de ieșire.
De ce apare: cauzele frecvente
1Valoare din alt API
output_config={"effort": "minimal"}output_config={"effort": "low"}Claude nu are nivelul minimal; cel mai mic nivel este low.
2Majuscule sau traducere
output_config={"effort": "Low"}
output_config={"effort": "mic"}output_config={"effort": "low"}Comparația e exactă: textul trebuie să fie identic cu una dintre valorile permise.
3Număr în loc de text
output_config={"effort": 1}output_config={"effort": "low"}Nivelurile sunt nume, nu numere.
Repară eroarea, direct în pagină
Un clasificator de e-mailuri trebuie să ruleze ieftin, cu efort minim, dar cererea cade cu output_config.effort: Input should be 'low', 'medium', 'high', 'xhigh' or 'max'. Pune cel mai mic nivel de efort acceptat de API și afișează categoria primită.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
email = "Bună ziua, coletul meu a ajuns deteriorat și aș vrea banii înapoi."
r = client.messages.create(
model=MODEL,
max_tokens=20,
output_config={"effort": "minimal"},
system="Clasifici e-mailurile într-un cuvânt: retur, livrare, factura sau altele.",
messages=[{"role": "user", "content": email}],
)
print("Categorie:", r.content[0].text)Categorie: retur
Indiciu
Cel mai mic nivel permis de Claude este "low".
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
email = "Bună ziua, coletul meu a ajuns deteriorat și aș vrea banii înapoi."
r = client.messages.create(
model=MODEL,
max_tokens=20,
output_config={"effort": "low"},
system="Clasifici e-mailurile într-un cuvânt: retur, livrare, factura sau altele.",
messages=[{"role": "user", "content": email}],
)
print("Categorie:", r.content[0].text)De ce merge
API-ul validează effort față de o listă fixă de valori, iar "minimal" nu e în ea. Cel mai mic nivel acceptat este "low", potrivit pentru sarcini simple ca o clasificare într-un singur cuvânt: răspunsul vine mai repede și costă mai puțin. Valoarea corectă face cererea validă, iar modelul răspunde normal.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - {'type': 'error', 'error': {'type': 'invalid_request_error', 'message': "output_config.effort: Input should be 'low', 'medium', 'high', 'xhigh' or 'max'"}}
Cum o eviți pe viitor
- Ține nivelurile într-o constantă, de exemplu
EFORT_SIMPLU = "low",EFORT_GREU = "high", în loc să le scrii de mână la fiecare apel. - Dacă nivelul vine din configurare sau de la utilizator, validează-l înainte de apel față de lista permisă.
- Lasă implicit (
medium) acolo unde nu ai un motiv clar să-l schimbi.
Întrebări frecvente
Ce nivel să aleg?
low pentru sarcini simple și repetitive (clasificare, extragere scurtă), medium ca valoare obișnuită, high sau mai mult pentru raționamente lungi, cod sau analiză. Testează pe exemple reale și compară costul cu calitatea.
Effort înlocuiește temperature?
Nu, au roluri diferite. API-ul Claude actual nu mai acceptă temperature; stilul îl controlezi prin instrucțiuni, iar effort controlează cât lucrează modelul, deci costul și calitatea.
Erori înrudite
TypeError: create() got an unexpected keyword argument 'temperature' Versiunea actuală a API-ului Claude nu mai acceptă `temperature` (nici `top_p`, `top_k`), așa că SDK-ul respinge argumentul. Scoate-l din apel; tonul și consecvența le controlezi prin system prompt, iar cât „gândește” modelul prin `output_config={"effort": "low"}`. anthropic.BadRequestError: Error code: 400 - thinking.type: 'enabled' with budget_tokens is not supported for this model; use {"type": "adaptive"} Modelele Claude actuale nu mai acceptă gândirea cu buget fix de tokeni (thinking={"type": "enabled", "budget_tokens": ...}). Folosește thinking={"type": "adaptive"} sau lasă parametrul deoparte, iar cât lucrează modelul îl reglezi cu output_config={"effort": ...}. 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. Î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.
