anthropic.BadRequestError: Error code: 400 - messages: at least one message is required
Ai trimis cererea cu lista messages goală. API-ul are nevoie de cel puțin un mesaj user. De obicei mesajul utilizatorului e adăugat în istoric după apel în loc de înainte, sau istoricul a fost golit ori tăiat complet.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
API-ul Messages generează răspunsul pornind de la conversație, iar o conversație goală nu are la ce să răspundă. system singur nu ajunge: instrucțiunile sunt context, nu un mesaj de la utilizator.
Eroarea apare aproape mereu dintr-o greșeală de ordine sau de date: adaugi întrebarea în istoric după messages.create, variabila trimisă e alta decât cea în care ai adăugat (mesaje vs istoric), o funcție de tăiere a istoricului păstrează zero mesaje, sau istoricul vine dintr-o sesiune nouă, încă goală.
La prima întrebare din conversație apare imediat. Uită-te la valoarea lui messages chiar înainte de apel (un print(len(istoric)) ajută).
De ce apare: cauzele frecvente
1Mesajul adăugat după apel
r = client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
istoric.append({"role": "user", "content": text})istoric.append({"role": "user", "content": text})
r = client.messages.create(model=MODEL, max_tokens=300, messages=istoric)La primul apel istoric e încă gol. Întrebarea trebuie să fie în listă înainte să trimiți cererea.
2Tăierea istoricului păstrează zero mesaje
MAX_MESAJE = 0 # din configurare
mesaje = istoric[-MAX_MESAJE:] if MAX_MESAJE else []mesaje = istoric[-MAX_MESAJE:] if MAX_MESAJE else istoric[-1:]Indiferent de buget, ultimul mesaj al utilizatorului trebuie trimis mereu.
3Altă listă decât cea completată
mesaje = []
istoric.append({"role": "user", "content": text})
client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)istoric.append({"role": "user", "content": text})
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)O variabilă cu nume asemănător, rămasă goală, ajunge în cerere în locul istoricului real.
Repară eroarea, direct în pagină
Chatbotul de mai jos cade la prima întrebare cu messages: at least one message is required. Repară funcția intreaba: adaugă întrebarea în istoric înainte de apel, iar după apel adaugă și răspunsul asistentului, ca a doua întrebare să aibă context. Programul afișează cele două răspunsuri.
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = []
def intreaba(text):
r = client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
istoric.append({"role": "user", "content": text})
return r.content[0].text
print(intreaba("Livrați și în Brașov?"))
print(intreaba("Cât costă?"))Da, livrăm în Brașov în 2 zile lucrătoare. Livrarea costă 15 lei, gratuită peste 200 de lei.
Indiciu
Ordinea corectă: append user, messages.create, append assistant.
Reparația
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = []
def intreaba(text):
istoric.append({"role": "user", "content": text})
r = client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
raspuns = r.content[0].text
istoric.append({"role": "assistant", "content": raspuns})
return raspuns
print(intreaba("Livrați și în Brașov?"))
print(intreaba("Cât costă?"))De ce merge
La primul apel, lista istoric era goală, pentru că întrebarea se adăuga abia după cerere. API-ul nu are la ce să răspundă și întoarce 400. Cu întrebarea adăugată înainte, fiecare cerere se termină cu mesajul curent al utilizatorului, iar răspunsul salvat în istoric îi dă modelului contextul pentru „Cât costă?”, care altfel n-ar avea sens.
Alte forme ale mesajului
anthropic.BadRequestError: Error code: 400 - {'type': 'error', 'error': {'type': 'invalid_request_error', 'message': 'messages: at least one message is required'}}openai.BadRequestError: Error code: 400 - [] is too short - 'messages'
Cum o eviți pe viitor
- Scrie o singură funcție care adaugă întrebarea, trimite istoricul și adaugă răspunsul, în ordinea asta.
- Verifică înainte de apel:
if not istoric: raise ValueError("istoric gol"), ca eroarea să apară în codul tău, nu în API. - La tăierea istoricului păstrează întotdeauna ultimul mesaj user.
Întrebări frecvente
Nu ajunge să trimit doar system?
Nu. system setează comportamentul, dar modelul răspunde la mesajele din messages, iar lista trebuie să înceapă cu un mesaj user.
De ce merge de la a doua întrebare?
Dacă adaugi întrebarea după apel, la al doilea apel lista conține deja prima întrebare. Doar că modelul răspunde atunci mereu la întrebarea anterioară, deci programul e greșit și când nu dă eroare.
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 - messages.2: all messages must have non-empty content except for the optional final assistant message Unul dintre mesajele trimise are conținut gol ("" sau listă goală). Numărul din messages.2 îți spune poziția lui în listă. Nu adăuga în istoric mesaje goale: verifică textul utilizatorului după strip() și răspunsurile asistentului înainte să le salvezi. 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.
