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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Eroarea vine din SDK-ul anthropic, înainte ca cererea să plece spre server: funcția messages.create verifică dacă ai dat toate argumentele obligatorii. Mesajul enumeră combinațiile acceptate: max_tokens, messages și model (plus stream, dacă folosești streaming). Dacă lipsește oricare, primești TypeError.
Aproape mereu lipsește max_tokens. La OpenAI parametrul echivalent (max_output_tokens în Responses API) e opțional, deci codul adaptat de acolo sau scris din memorie îl omite. La Claude, max_tokens e obligatoriu: e plafonul de tokeni pe care modelul îi poate genera în răspuns, adică și plafonul de cost al ieșirii.
Mai rar, lipsește model (o constantă scrisă greșit, de exemplu modell=MODEL, dă o altă eroare, unexpected keyword argument) sau messages (ai trimis textul ca prompt=). Linia din traceback e chiar apelul la create.
De ce apare: cauzele frecvente
1Apel fără max_tokens, copiat după un exemplu OpenAI
raspuns = client.messages.create(
model=MODEL,
messages=[{"role": "user", "content": intrebare}],
)raspuns = client.messages.create(
model=MODEL,
max_tokens=500,
messages=[{"role": "user", "content": intrebare}],
)Claude cere explicit limita de tokeni pentru răspuns. Cu max_tokens prezent, apelul are toate cele trei argumente obligatorii.
2Textul trimis cu prompt= în loc de messages=
raspuns = client.messages.create(model=MODEL, max_tokens=300, prompt=intrebare)raspuns = client.messages.create(model=MODEL, max_tokens=300,
messages=[{"role": "user", "content": intrebare}])Messages API primește conversația ca listă de mesaje cu role și content, nu un singur text în prompt.
Repară eroarea, direct în pagină
Codul de mai jos dă TypeError: Missing required arguments; Expected either ('max_tokens', 'messages' and 'model') .... Repară apelul ca să trimită întrebarea cu maximum 300 de tokeni de răspuns, apoi afișează textul răspunsului și, pe linia următoare, stop_reason: ....
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
raspuns = client.messages.create(
model=MODEL,
messages=[{"role": "user", "content": "Ce acte îmi trebuie pentru înscrierea la școala de șoferi?"}],
)
print(raspuns.content[0].text)
print("stop_reason:", raspuns.stop_reason)Ai nevoie de cartea de identitate, fișa medicală și avizul psihologic. stop_reason: end_turn
Indiciu
Din cele trei argumente obligatorii (model, max_tokens, messages), unul lipsește.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
raspuns = client.messages.create(
model=MODEL,
max_tokens=300,
messages=[{"role": "user", "content": "Ce acte îmi trebuie pentru înscrierea la școala de șoferi?"}],
)
print(raspuns.content[0].text)
print("stop_reason:", raspuns.stop_reason)De ce merge
SDK-ul anthropic verifică argumentele obligatorii înainte să trimită cererea, iar max_tokens lipsea. Cu max_tokens=300, modelul știe cât poate genera, iar tu ai un plafon clar pentru lungimea și costul răspunsului. stop_reason: end_turn arată că răspunsul a încăput în limită; dacă ar fi fost max_tokens, limita ar fi fost prea mică.
Alte forme ale mesajului
TypeError: Missing required arguments; Expected either ('max_tokens', 'messages' and 'model') or ('max_tokens', 'messages', 'model' and 'stream') arguments to be given
Cum o eviți pe viitor
- Scrie o singură funcție
intreaba(...)pentru tot proiectul, cumax_tokensșiMODELpuse o dată, și folosește-o peste tot. - Alege
max_tokensdupă răspunsul așteptat: câteva sute pentru un răspuns de chat, mai mult pentru texte lungi. - Verifică
stop_reason: dacă emax_tokens, limita a fost prea mică și răspunsul e tăiat.
Întrebări frecvente
Cât să pun la max_tokens?
Cât are nevoie răspunsul, cu o marjă: 300–1000 pentru răspunsuri de chat, câteva mii pentru documente lungi. Plătești doar tokenii generați efectiv, nu limita, dar o limită prea mică taie răspunsul.
De ce la OpenAI merge fără?
Pentru că la OpenAI limita de ieșire e opțională (max_output_tokens). API-ul Claude a ales să o facă obligatorie, ca să controlezi mereu lungimea și costul răspunsului.
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: 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"}`. 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.
