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`.
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
messages=[
{"role": "user", "content": "Extrage numele și orașul: Ana, din Brașov."},
{"role": "assistant", "content": "{"},
]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ă
istoric.append({"role": "assistant", "content": raspuns_vechi})
client.messages.create(model=MODEL, max_tokens=300, messages=istoric)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ă 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ș: ....
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"])Nume: Ioana Pop Oraș: Sibiu
Indiciu
Conversația trebuie să se termine cu mesajul user; schema e deja în constanta SCHEMA.
Reparația
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."},
],
output_config={"format": {"type": "json_schema", "schema": SCHEMA}},
)
date = json.loads(raspuns.content[0].text)
print("Nume:", date["nume"])
print("Oraș:", date["oras"])De ce merge
Modelele actuale nu mai continuă un răspuns început de tine, deci ultimul mesaj trebuie să fie al utilizatorului. Ce urmăreai cu prefill, un răspuns care e doar JSON, obții acum cu ieșirea structurată: cu output_config și schema, primul bloc text e JSON valid, cu câmpurile cerute, iar json.loads îl citește direct.
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_configcujson_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
assistantpuse 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
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. json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) `json.loads` a primit un text care nu începe cu JSON: modelul a pus JSON-ul între ```json ... ``` sau a scris o propoziție înainte. Cere ieșire structurată (`output_config` cu `json_schema` la Claude, `text.format` la OpenAI) sau scoate marcajele înainte de `json.loads`. 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=`. Î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.
