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

anthropic.BadRequestError: Error code: 400 - output_config.effort: Input should be 'low', 'medium', 'high', 'xhigh' or 'max'

Pe scurt

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

Greșit
PYTHON
output_config={"effort": "minimal"}
Corect
PYTHON
output_config={"effort": "low"}

Claude nu are nivelul minimal; cel mai mic nivel este low.

2Majuscule sau traducere

Greșit
PYTHON
output_config={"effort": "Low"}
output_config={"effort": "mic"}
Corect
PYTHON
output_config={"effort": "low"}

Comparația e exactă: textul trebuie să fie identic cu una dintre valorile permise.

3Număr în loc de text

Greșit
PYTHON
output_config={"effort": 1}
Corect
PYTHON
output_config={"effort": "low"}

Nivelurile sunt nume, nu numere.

Repară tu

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

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

Cel mai mic nivel permis de Claude este "low".

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

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