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

anthropic.BadRequestError: Error code: 400 - messages: at least one message is required

Pe scurt

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

Greșit
PYTHON
r = client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
istoric.append({"role": "user", "content": text})
Corect
PYTHON
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

Greșit
PYTHON
MAX_MESAJE = 0  # din configurare
mesaje = istoric[-MAX_MESAJE:] if MAX_MESAJE else []
Corect
PYTHON
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ă

Greșit
PYTHON
mesaje = []
istoric.append({"role": "user", "content": text})
client.messages.create(model=MODEL, max_tokens=300, messages=mesaje)
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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ă?"))
După reparație, programul afișează
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.

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

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