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

messages: Unexpected role "system". The Messages API accepts a top-level `system` parameter, not "system" as an input message role.

Pe scurt

Ai pus instrucțiunile ca mesaj cu `"role": "system"` în lista `messages`, ca la OpenAI. La API-ul Claude, lista conține doar roluri `user` și `assistant`; system prompt-ul se trimite separat, în parametrul `system=`.

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

Ce înseamnă

La Chat Completions (OpenAI), instrucțiunile generale sunt primul mesaj din listă, cu rolul system. La Messages API (Claude), structura e diferită: messages conține doar replicile conversației (user și assistant), iar instrucțiunile stau în parametrul de nivel superior system. Mesajul erorii spune exact asta: rolul „system” nu e acceptat ca rol de mesaj.

Eroarea apare aproape mereu când muți un program de la OpenAI la Claude sau când construiești o funcție comună pentru ambii furnizori. În mediul cursului, simulatorul o raportează cu forma messages.0.role: Input should be 'user' or 'assistant', unde 0 e poziția mesajului problemă în listă.

Reparația: scoți mesajul system din listă și îi dai conținutul în system=. La Responses API (OpenAI), echivalentul este instructions=.

De ce apare: cauzele frecvente

1Mesaj system pus în listă, ca la OpenAI

Greșit
PYTHON
r = client.messages.create(model=MODEL, max_tokens=300, messages=[
    {"role": "system", "content": "Ești asistentul unei pizzerii."},
    {"role": "user", "content": "Aveți pizza fără gluten?"},
])
Corect
PYTHON
r = client.messages.create(model=MODEL, max_tokens=300,
    system="Ești asistentul unei pizzerii.",
    messages=[{"role": "user", "content": "Aveți pizza fără gluten?"}])

Claude primește instrucțiunile în system=, iar lista de mesaje începe direct cu utilizatorul.

2Istoric salvat de la OpenAI și refolosit la Claude

Greșit
PYTHON
istoric = [{"role": "system", "content": SYSTEM}] + conversatie
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
Corect
PYTHON
sistem = [m["content"] for m in istoric if m["role"] == "system"]
mesaje = [m for m in istoric if m["role"] != "system"]
client.messages.create(model=MODEL, max_tokens=300, system="\n".join(sistem), messages=mesaje)

Când convertești o conversație între furnizori, separă mesajele system și trimite-le în parametrul dedicat.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos, mutat de la OpenAI la Claude, dă o eroare 400 pentru rolul system din messages (în editor: messages.0.role: Input should be 'user' or 'assistant'). Repară apelul: instrucțiunile din SYSTEM merg în parametrul system=, iar messages păstrează doar mesajul clientului. Programul afișează răspunsul.

Codul care dă eroarea
PYTHON
import anthropic

MODEL = "claude-haiku-5-5"
SYSTEM = "Ești asistentul unei pizzerii din Timișoara. Răspunzi scurt și prietenos."
client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=200,
    messages=[
        {"role": "system", "content": SYSTEM},
        {"role": "user", "content": "Aveți pizza fără gluten?"},
    ],
)
print(raspuns.content[0].text)
După reparație, programul afișează
Da, avem blat fără gluten pentru toate pizzele, cu 8 lei în plus.
Indiciu

Scoate primul element din listă și trimite textul lui cu system=SYSTEM.

Alte forme ale mesajului

  • anthropic.BadRequestError: Error code: 400 - invalid_request_error: messages.0.role: Input should be 'user' or 'assistant'

Cum o eviți pe viitor

  • Ține system prompt-ul într-o constantă SYSTEM și trimite-l mereu prin parametrul dedicat: system= la Claude, instructions= la OpenAI Responses.
  • Dacă aplicația folosește ambii furnizori, scrie câte o funcție mică de conversie a istoricului pentru fiecare.
  • Validează rolurile înainte de trimitere: la Claude, doar user și assistant.

Întrebări frecvente

De ce Claude nu acceptă rolul system în listă?

Așa e proiectat Messages API: instrucțiunile generale sunt separate de conversație, într-un parametru propriu. Efectul e același, doar locul diferă.

Pot schimba system prompt-ul la mijlocul conversației?

Da, system se trimite la fiecare apel, deci poți trimite altă valoare oricând. Lista messages rămâne doar cu replicile user și assistant.

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.