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

TypeError: Missing required arguments; Expected either ('max_tokens', 'messages' and 'model') or ('max_tokens', 'messages', 'model' and 'stream') arguments to be given

Pe scurt

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

Greșit
PYTHON
raspuns = client.messages.create(
    model=MODEL,
    messages=[{"role": "user", "content": intrebare}],
)
Corect
PYTHON
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=

Greșit
PYTHON
raspuns = client.messages.create(model=MODEL, max_tokens=300, prompt=intrebare)
Corect
PYTHON
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ă tu

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

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

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, cu max_tokens și MODEL puse o dată, și folosește-o peste tot.
  • Alege max_tokens după răspunsul așteptat: câteva sute pentru un răspuns de chat, mai mult pentru texte lungi.
  • Verifică stop_reason: dacă e max_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

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