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

TypeError: Responses.create() got an unexpected keyword argument 'messages'

Pe scurt

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

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

SDK-ul verifică numele parametrilor înainte să trimită cererea. Responses.create() nu are parametrul messages, așa că refuză apelul cu TypeError, fără niciun cost.

Cele trei API-uri folosesc nume diferite pentru aceleași idei:

  • Claude messages.create: messages=, system=, max_tokens= (obligatoriu).
  • OpenAI responses.create: input=, instructions=, max_output_tokens=.
  • OpenAI chat.completions.create (vechi): messages=, cu instrucțiunile ca mesaj system, și max_completion_tokens=.

Eroarea apare aproape mereu când muți cod de pe un API pe altul. Numele din ghilimele îți spune ce parametru trebuie redenumit; după ce îl repari, poate apărea următorul.

De ce apare: cauzele frecvente

1Cod Chat Completions trimis la Responses

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

În Responses API, conversația (sau un simplu text) se dă în input=.

2max_tokens în loc de max_output_tokens

Greșit
PYTHON
r = client.responses.create(model="gpt-6-luna", input=text, max_tokens=200)
Corect
PYTHON
r = client.responses.create(model="gpt-6-luna", input=text, max_output_tokens=200)

Limita de ieșire are alt nume în Responses: max_output_tokens.

3Parametri OpenAI trimiși la Claude

Greșit
PYTHON
r = client.messages.create(model=MODEL, instructions="Ești politicos.", input=text)
Corect
PYTHON
r = client.messages.create(model=MODEL, max_tokens=300, system="Ești politicos.",
                           messages=[{"role": "user", "content": text}])

Claude primește instrucțiunile în system= și conversația în messages=; max_tokens e obligatoriu.

Repară tu

Repară eroarea, direct în pagină

Codul a fost mutat de pe Chat Completions pe OpenAI Responses API și cade cu TypeError: Responses.create() got an unexpected keyword argument 'messages'. Redenumește parametrii pentru Responses: instrucțiunea în instructions=, întrebarea în input=, limita în max_output_tokens=200, apoi afișează r.output_text.

Codul care dă eroarea
PYTHON
from openai import OpenAI

MODEL = "gpt-6-luna"
client = OpenAI()

r = client.responses.create(
    model=MODEL,
    messages=[
        {"role": "system", "content": "Ești asistentul unei școli de șoferi."},
        {"role": "user", "content": "Câte ore de condus include cursul?"},
    ],
    max_tokens=200,
)
print(r.output_text)
După reparație, programul afișează
Cursul include 30 de ore de condus și 24 de ore de legislație.
Indiciu

messages devine input, mesajul system devine instructions, iar max_tokens devine max_output_tokens.

Alte forme ale mesajului

  • TypeError: Responses.create() got an unexpected keyword argument 'max_tokens'
  • TypeError: Messages.create() got an unexpected keyword argument 'input'
  • TypeError: Messages.create() got an unexpected keyword argument 'instructions'
  • TypeError: Completions.create() got an unexpected keyword argument 'input'

Cum o eviți pe viitor

  • Păstrează lângă cod un mic tabel cu numele parametrilor pentru fiecare API folosit.
  • Pune apelul fiecărui furnizor într-o funcție proprie (intreaba_claude, intreaba_gpt), iar restul aplicației să folosească doar funcțiile tale.
  • Verifică documentația API-ului exact pe care îl folosești, nu un tutorial vechi.

Întrebări frecvente

Pot da aceeași listă de mesaje și la Responses?

Da: input= acceptă și o listă de mesaje {"role": ..., "content": ...}. Se schimbă doar numele parametrului, iar instrucțiunile generale merg separat, în instructions=.

De ce nu dă eroare API-ul, ci Python?

SDK-ul are semnătura metodei cu toți parametrii permiși. Un nume necunoscut e respins local, înainte de orice cerere pe rețea, deci nu plătești nimic pentru greșeală.

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.