TypeError: Messages.create() takes 1 positional argument but 2 were given
Metodele SDK-ului primesc doar argumente cu nume (model=..., messages=...), iar tu ai dat o valoare pe poziție, de obicei un dicționar cu toți parametrii. Despachetează dicționarul cu client.messages.create(**parametri) sau scrie fiecare parametru cu numele lui.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
„1 positional argument” este self, adică obiectul client.messages, pe care Python îl pune automat. Metoda create a SDK-ului e definită cu *, deci acceptă numai argumente cu nume: model=, max_tokens=, messages=. Orice valoare dată fără nume se numără ca al doilea argument pozițional și produce eroarea.
Cel mai des se întâmplă când construiești cererea într-un dicționar (ca să o salvezi, să o testezi sau să o trimiți la batch) și apoi o dai direct: create(cerere). Alteori e numele modelului scris primul, ca într-un apel de funcție obișnuit.
La OpenAI, aceeași greșeală dă Responses.create() takes 1 positional argument but 2 were given.
De ce apare: cauzele frecvente
1Dicționarul de parametri dat fără **
cerere = {"model": MODEL, "max_tokens": 300, "messages": mesaje}
r = client.messages.create(cerere)cerere = {"model": MODEL, "max_tokens": 300, "messages": mesaje}
r = client.messages.create(**cerere)**cerere transformă fiecare cheie a dicționarului într-un argument cu nume, exact cum le așteaptă metoda.
2Modelul sau mesajul dat pe poziție
r = client.messages.create(MODEL, max_tokens=300, messages=mesaje)r = client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)SDK-ul nu acceptă argumente poziționale, ca să nu depindă de ordinea parametrilor. Scrie numele fiecăruia.
3Textul trimis direct la OpenAI Responses
r = client.responses.create("Salut!", model="gpt-6-luna")r = client.responses.create(model="gpt-6-luna", input="Salut!")Textul utilizatorului merge în parametrul input=.
Repară eroarea, direct în pagină
Funcția cerere_rezumat pregătește parametrii cererii într-un dicționar, ca să poată fi salvați în log, dar apelul cade cu TypeError: Messages.create() takes 1 positional argument but 2 were given (în editor apare _Messages.create()). Repară apelul ca programul să afișeze rezumatul.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
contract = "Chiria lunară este 2500 lei, plătibilă până pe 5 ale lunii. Preavizul de reziliere este de 30 de zile."
def cerere_rezumat(text):
return {
"model": MODEL,
"max_tokens": 200,
"system": "Rezumi contracte în maximum două propoziții.",
"messages": [{"role": "user", "content": "Rezumă contractul:\n" + text}],
}
params = cerere_rezumat(contract)
r = client.messages.create(params)
print(r.content[0].text)Chiria este de 2500 lei pe lună, cu plata până pe 5. Rezilierea cere un preaviz de 30 de zile.
Indiciu
Despachetează dicționarul în argumente cu nume.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
contract = "Chiria lunară este 2500 lei, plătibilă până pe 5 ale lunii. Preavizul de reziliere este de 30 de zile."
def cerere_rezumat(text):
return {
"model": MODEL,
"max_tokens": 200,
"system": "Rezumi contracte în maximum două propoziții.",
"messages": [{"role": "user", "content": "Rezumă contractul:\n" + text}],
}
params = cerere_rezumat(contract)
r = client.messages.create(**params)
print(r.content[0].text)De ce merge
client.messages.create acceptă doar argumente cu nume. Dat direct, dicționarul ajunge ca argument pozițional, pe lângă self, de unde „2 were given”. Cu **params, fiecare cheie devine argumentul cu același nume: model=, max_tokens=, system=, messages=. Dicționarul rămâne util pentru log sau pentru Batch API, unde cererile chiar se dau ca dicționare.
Alte forme ale mesajului
TypeError: Responses.create() takes 1 positional argument but 2 were givenTypeError: Completions.create() takes 1 positional argument but 2 were givenTypeError: Messages.create() takes 1 positional argument but 3 were given
Cum o eviți pe viitor
- Scrie mereu parametrii cu nume în apelurile SDK-ului.
- Când pregătești cererea într-un dicționar, trimite-o cu
**cerere. - O funcție proprie, de exemplu
intreaba(text, max_tokens=300), ascunde detaliile apelului și le scrie corect într-un singur loc. - Un editor cu completare automată îți arată semnătura metodei și numele parametrilor.
Întrebări frecvente
De ce SDK-ul nu acceptă argumente poziționale?
Pentru că are zeci de parametri opționali. Cu nume obligatorii, codul rămâne corect și clar chiar dacă ordinea parametrilor se schimbă într-o versiune nouă.
Ce face exact ** în apel?
Despachetează dicționarul: create(**{"model": "x", "max_tokens": 5}) este echivalent cu create(model="x", max_tokens=5).
Erori înrudite
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. 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"}`. TypeError: Responses.create() got an unexpected keyword argument 'messages' Ai trimis la OpenAI Responses API parametri din alt API (messages=, max_tokens=, system=). Responses primește conversația în input=, instrucțiunile în instructions= și limita în max_output_tokens=. La Claude e invers: messages=, system=, max_tokens=. Î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.
