messages: Unexpected role "system". The Messages API accepts a top-level `system` parameter, not "system" as an input message role.
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
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?"},
])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
istoric = [{"role": "system", "content": SYSTEM}] + conversatie
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)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ă 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.
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)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.
Reparația
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,
system=SYSTEM,
messages=[
{"role": "user", "content": "Aveți pizza fără gluten?"},
],
)
print(raspuns.content[0].text)De ce merge
La Messages API, lista messages conține doar replicile user și assistant, iar instrucțiunile generale au parametrul lor, system. Mutând textul din primul mesaj în system=SYSTEM, cererea devine validă: conversația începe cu utilizatorul, iar modelul primește aceleași instrucțiuni ca înainte. La OpenAI Responses API, același text ar merge în instructions=.
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șiassistant.
Î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
anthropic.BadRequestError: Error code: 400 - messages: first message must use the "user" role Lista `messages` începe cu un mesaj `assistant`, iar API-ul Claude cere ca primul mesaj să fie de la `user`. Apare des după ce tai istoricul conversației și rămâne în față un răspuns al asistentului: taie în perechi sau scoate mesajele `assistant` de la început. anthropic.BadRequestError: Error code: 400 - This model does not support assistant message prefill. The conversation must end with a user message. Ultimul mesaj din `messages` e de la `assistant` (tehnica „prefill”, folosită ca să forțezi începutul răspunsului, de exemplu `{`), iar modelele Claude actuale nu o mai acceptă. Conversația trebuie să se termine cu un mesaj `user`; pentru JSON garantat folosește `output_config` cu `format` de tip `json_schema`. 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"}`. Î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.
