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

TypeError: Messages.create() takes 1 positional argument but 2 were given

Pe scurt

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

Greșit
PYTHON
cerere = {"model": MODEL, "max_tokens": 300, "messages": mesaje}
r = client.messages.create(cerere)
Corect
PYTHON
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

Greșit
PYTHON
r = client.messages.create(MODEL, max_tokens=300, messages=mesaje)
Corect
PYTHON
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

Greșit
PYTHON
r = client.responses.create("Salut!", model="gpt-6-luna")
Corect
PYTHON
r = client.responses.create(model="gpt-6-luna", input="Salut!")

Textul utilizatorului merge în parametrul input=.

Repară tu

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.

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

Alte forme ale mesajului

  • TypeError: Responses.create() takes 1 positional argument but 2 were given
  • TypeError: Completions.create() takes 1 positional argument but 2 were given
  • TypeError: 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

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