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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
O conversație trimisă la Claude trebuie să înceapă cu utilizatorul și să alterneze, în principiu, user și assistant. Mesajul îți spune că primul element din messages are rolul assistant.
Cazul clasic e chatbotul care păstrează doar ultimele N mesaje ca să nu depășească fereastra de context. Dacă N e impar sau tăierea nu ține cont de perechi, lista rămasă poate începe cu un răspuns al asistentului. Alt caz frecvent: un mesaj de bun venit („Bună! Cu ce te ajut?”) afișat în interfață și salvat în istoric ca primul mesaj assistant.
Reparația: după orice tăiere, elimină mesajele de la început până dai de unul user; mesajele de bun venit le ții doar în interfață sau le transformi în instrucțiuni în system.
De ce apare: cauzele frecvente
1Istoric tăiat la un număr impar de mesaje
ultimele = istoric[-3:] # poate începe cu "assistant"
client.messages.create(model=MODEL, max_tokens=300, messages=ultimele)ultimele = istoric[-3:]
while ultimele and ultimele[0]["role"] != "user":
ultimele = ultimele[1:]
client.messages.create(model=MODEL, max_tokens=300, messages=ultimele)După tăiere, elimini mesajele de la început până când primul e de la utilizator.
2Mesajul de bun venit salvat în istoric
istoric = [{"role": "assistant", "content": "Bună! Cu ce te pot ajuta?"}]
istoric.append({"role": "user", "content": mesaj})istoric = [] # salutul e doar în interfață
istoric.append({"role": "user", "content": mesaj})Salutul nu e un răspuns la o întrebare a utilizatorului, deci nu are ce căuta la începutul conversației trimise la API.
Repară eroarea, direct în pagină
Chatbotul de mai jos păstrează doar ultimele 4 mesaje din istoric și primește o eroare 400 (first message must use the "user" role). Repară funcția ultimele_mesaje(istoric, n): după tăiere, scoate mesajele de la început până când primul este de la user. Programul afișează rolul primului mesaj trimis și răspunsul.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = [
{"role": "user", "content": "Bună, am comandat o canapea."},
{"role": "assistant", "content": "Bună! Spune-mi numărul comenzii, te rog."},
{"role": "user", "content": "Comanda 5521."},
{"role": "assistant", "content": "Comanda 5521 este în depozit și pleacă mâine."},
{"role": "user", "content": "Când ajunge la Cluj?"},
]
def ultimele_mesaje(istoric, n):
return istoric[-n:]
mesaje = ultimele_mesaje(istoric, 4)
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=mesaje)
print("primul rol:", mesaje[0]["role"])
print(raspuns.content[0].text)primul rol: user Comanda 5521 ajunge la Cluj în 2 zile lucrătoare de la plecarea din depozit.
Indiciu
Un while care scoate primul element cât timp rolul lui nu e user.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = [
{"role": "user", "content": "Bună, am comandat o canapea."},
{"role": "assistant", "content": "Bună! Spune-mi numărul comenzii, te rog."},
{"role": "user", "content": "Comanda 5521."},
{"role": "assistant", "content": "Comanda 5521 este în depozit și pleacă mâine."},
{"role": "user", "content": "Când ajunge la Cluj?"},
]
def ultimele_mesaje(istoric, n):
mesaje = istoric[-n:]
while mesaje and mesaje[0]["role"] != "user":
mesaje = mesaje[1:]
return mesaje
mesaje = ultimele_mesaje(istoric, 4)
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=mesaje)
print("primul rol:", mesaje[0]["role"])
print(raspuns.content[0].text)De ce merge
Ultimele 4 mesaje din istoric încep cu un răspuns al asistentului („Bună! Spune-mi numărul comenzii...”), iar API-ul cere ca conversația să înceapă cu utilizatorul. Bucla while scoate mesajele de la început până la primul user, deci orice tăiere produce o listă validă.
Într-o aplicație reală, tai istoricul în perechi întrebare-răspuns: modelul păstrează contextul coerent și lista începe mereu corect.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - invalid_request_error: messages: first message must use the "user" role
Cum o eviți pe viitor
- Când limitezi istoricul, taie în perechi (întrebare + răspuns), nu la un număr oarecare de mesaje.
- Scrie o funcție
pregateste_istoric(...)care taie, verifică primul rol și o folosește la fiecare apel. - Mesajele de interfață (salut, sugestii) nu intră în
messages; ce trebuie să știe modelul pui însystem.
Întrebări frecvente
De ce contează cine vorbește primul?
Pentru că Messages API modelează o conversație în care asistentul răspunde utilizatorului. Un răspuns fără o întrebare înainte nu are sens în acest format, deci API-ul îl respinge.
OpenAI acceptă istoric care începe cu assistant?
Formatul OpenAI e mai permisiv, dar ideea de a tăia istoricul în perechi rămâne bună practică la ambii furnizori: modelul înțelege mai bine conversația.
Erori înrudite
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=`. 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`. anthropic.BadRequestError: Error code: 400 - prompt is too long: 1048712 tokens > 1000000 maximum Tot ce trimiți (system prompt, istoricul conversației, documentele, tool-urile) depășește fereastra de context a modelului. Scurtează cererea: păstrează doar ultimele mesaje, rezumă istoricul vechi și trimite doar bucățile relevante din documente (RAG), nu documentele întregi. Î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.
