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

anthropic.BadRequestError: Error code: 400 - This model does not support assistant message prefill. The conversation must end with a user message.

Pe scurt

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

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

Ce înseamnă

„Prefill” înseamnă să pui la finalul conversației un mesaj assistant început de tine, pe care modelul îl continuă. Era o tehnică populară: trimiteai {"role": "assistant", "content": "{"} ca modelul să răspundă direct cu JSON, fără text înainte. La modelele actuale, API-ul refuză asta: ultimul mesaj trebuie să fie al utilizatorului.

Eroarea apare când folosești rețete vechi de prompt engineering sau când, într-un chatbot, adaugi din greșeală răspunsul asistentului în istoric înainte de apel (de două ori, sau fără întrebarea nouă).

Pentru JSON există acum o metodă mai sigură decât prefill: ieșirea structurată, output_config={"format": {"type": "json_schema", "schema": {...}}}, care garantează că răspunsul e JSON valid după schema ta. Pentru stil, pui instrucțiunea în system.

De ce apare: cauzele frecvente

1Prefill cu acoladă pentru JSON

Greșit
PYTHON
messages=[
    {"role": "user", "content": "Extrage numele și orașul: Ana, din Brașov."},
    {"role": "assistant", "content": "{"},
]
Corect
PYTHON
messages=[{"role": "user", "content": "Extrage numele și orașul: Ana, din Brașov."}],
output_config={"format": {"type": "json_schema", "schema": SCHEMA}},

Ieșirea structurată garantează JSON valid fără să mai pui începutul răspunsului în conversație.

2Răspunsul adăugat în istoric înainte de întrebarea nouă

Greșit
PYTHON
istoric.append({"role": "assistant", "content": raspuns_vechi})
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)
Corect
PYTHON
istoric.append({"role": "assistant", "content": raspuns_vechi})
istoric.append({"role": "user", "content": mesaj_nou})
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)

Fiecare apel trebuie să se încheie cu replica utilizatorului la care aștepți răspuns.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos folosește prefill (un mesaj assistant cu { la final) ca să obțină JSON și primește 400: This model does not support assistant message prefill. Scoate mesajul assistant și cere JSON prin output_config={"format": {"type": "json_schema", "schema": SCHEMA}}. Programul citește JSON-ul și afișează Nume: ... și Oraș: ....

Codul care dă eroarea
PYTHON
import json

import anthropic

MODEL = "claude-haiku-5-5"
SCHEMA = {
    "type": "object",
    "properties": {"nume": {"type": "string"}, "oras": {"type": "string"}},
    "required": ["nume", "oras"],
    "additionalProperties": False,
}
client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=200,
    messages=[
        {"role": "user", "content": "Extrage numele și orașul: Bună, sunt Ioana Pop și locuiesc în Sibiu."},
        {"role": "assistant", "content": "{"},
    ],
)
date = json.loads("{" + raspuns.content[0].text)
print("Nume:", date["nume"])
print("Oraș:", date["oras"])
După reparație, programul afișează
Nume: Ioana Pop
Oraș: Sibiu
Indiciu

Conversația trebuie să se termine cu mesajul user; schema e deja în constanta SCHEMA.

Alte forme ale mesajului

  • anthropic.BadRequestError: Error code: 400 - invalid_request_error: This model does not support assistant message prefill. The conversation must end with a user message.

Cum o eviți pe viitor

  • Înainte de fiecare apel, verifică messages[-1]["role"] == "user".
  • Pentru JSON, folosește ieșirea structurată (output_config cu json_schema), nu prefill.
  • Pentru formatul sau tonul răspunsului, scrie instrucțiuni clare în system și un exemplu.
  • Când adaptezi rețete vechi de prompt engineering, caută în ele mesajele assistant puse la final și înlocuiește-le cu instrucțiuni sau cu ieșire structurată.

Întrebări frecvente

Ce câștigam cu prefill și cum obțin același lucru acum?

Prefill forța începutul răspunsului (de exemplu {), ca să nu apară text înainte de JSON. Ieșirea structurată face asta mai bine: răspunsul respectă schema, iar json.loads nu mai eșuează.

Modelele mai vechi acceptau prefill?

Da, multe tutoriale îl folosesc. Modelele actuale îl resping cu acest 400, deci codul acela trebuie adaptat.

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.