TypeError: Object of type TextBlock is not JSON serializable
`json.dump` / `json.dumps` nu știe să salveze obiectele SDK-ului (`TextBlock`, `ToolUseBlock`, `Message`). Salvează textul (`bloc.text`) sau transformă obiectele în dicționare cu `bloc.model_dump()` înainte de `json.dumps`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Modulul json din Python știe să transforme în text doar tipurile de bază: dicționare, liste, șiruri, numere, True/False, None. Mesajul îți spune ce obiect a întâlnit și nu a știut să-l serializeze: un TextBlock, adică un bloc din response.content.
Situația tipică: chatbotul păstrează istoricul adăugând {"role": "assistant", "content": raspuns.content}. Pentru API asta e corect (SDK-ul acceptă blocurile înapoi), dar când vrei să salvezi conversația într-un fișier, în bază de date sau să o trimiți în browser, json.dumps dă peste obiecte. Același lucru se întâmplă cu ToolUseBlock, Message sau, la OpenAI, cu item-urile din response.output.
Ai două variante: salvezi doar textul ("content": text), care e și mai compact, sau transformi fiecare bloc în dicționar cu model_dump(), dacă ai nevoie de tot (de exemplu de blocurile tool_use).
De ce apare: cauzele frecvente
1Blocurile SDK-ului puse direct în istoricul salvat
istoric.append({"role": "assistant", "content": raspuns.content})
json.dump(istoric, f)text = "".join(b.text for b in raspuns.content if b.type == "text")
istoric.append({"role": "assistant", "content": text})
json.dump(istoric, f, ensure_ascii=False)Un șir de caractere se salvează fără probleme, iar API-ul acceptă și textul simplu ca content.
2Păstrarea tuturor blocurilor, inclusiv tool_use
json.dumps({"role": "assistant", "content": raspuns.content})json.dumps({"role": "assistant", "content": [b.model_dump() for b in raspuns.content]})model_dump() transformă fiecare bloc într-un dicționar cu aceleași câmpuri, pe care json îl poate scrie.
3Tot răspunsul salvat în log
log.info(json.dumps(raspuns))log.info(raspuns.model_dump_json())Obiectul Message are propria metodă de serializare în JSON.
Repară eroarea, direct în pagină
Programul de mai jos salvează conversația ca JSON și dă TypeError: Object of type TextBlock is not JSON serializable. Repară adăugarea răspunsului în istoric: pune în content textul lipit din blocurile text, nu blocurile SDK-ului. Programul afișează JSON-ul conversației.
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = [{"role": "user", "content": "Ce program are service-ul auto sâmbăta?"}]
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=istoric)
istoric.append({"role": "assistant", "content": raspuns.content})
print(json.dumps(istoric, ensure_ascii=False, indent=1))[
{
"role": "user",
"content": "Ce program are service-ul auto sâmbăta?"
},
{
"role": "assistant",
"content": "Sâmbăta service-ul e deschis între 9 și 14."
}
]Indiciu
Lipește textul cu "".join(b.text for b in raspuns.content if b.type == "text").
Reparația
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
istoric = [{"role": "user", "content": "Ce program are service-ul auto sâmbăta?"}]
raspuns = client.messages.create(model=MODEL, max_tokens=200, messages=istoric)
text = "".join(b.text for b in raspuns.content if b.type == "text")
istoric.append({"role": "assistant", "content": text})
print(json.dumps(istoric, ensure_ascii=False, indent=1))De ce merge
raspuns.content e o listă de obiecte TextBlock, pe care modulul json nu le cunoaște. Textul extras din ele e un șir obișnuit, deci istoricul devine format doar din dicționare și șiruri, iar json.dumps îl scrie fără probleme. Același istoric poate fi încărcat mai târziu și trimis înapoi la API.
Alte forme ale mesajului
TypeError: Object of type ToolUseBlock is not JSON serializableTypeError: Object of type Message is not JSON serializableTypeError: Object of type ResponseFunctionToolCall is not JSON serializable
Cum o eviți pe viitor
- Decide de la început formatul istoricului salvat: dicționare simple, cu
contenttext sau liste de dicționare. - Transformă obiectele SDK-ului (cu
model_dump()) într-un singur loc, la granița cu fișierul sau baza de date. - Pune
ensure_ascii=Falselajson.dump, ca diacriticele să rămână lizibile în fișier.
Întrebări frecvente
Pot trimite înapoi la API istoricul încărcat din JSON?
Da. API-ul acceptă content ca text sau ca listă de dicționare cu aceleași câmpuri ca blocurile (type, text, id, name, input), exact ce produce model_dump().
Ce face default=str la json.dumps?
Transformă orice obiect necunoscut în textul lui de afișare. Scapă de eroare, dar salvează ceva de genul TextBlock(...), pe care nu îl mai poți refolosi ca mesaj. Folosește model_dump().
Erori înrudite
TypeError: 'Message' object is not subscriptable Accesezi răspunsul SDK-ului ca pe un dicționar (`raspuns["content"]`), dar el e un obiect cu atribute. Folosește punctul: `raspuns.content[0].text`; dacă chiar îți trebuie un dicționar, transformă-l cu `raspuns.model_dump()`. TypeError: the JSON object must be str, bytes or bytearray, not list Ai dat lui `json.loads` lista de blocuri `raspuns.content`, nu textul din ea. `json.loads` primește doar text: folosește `json.loads(raspuns.content[0].text)` (sau textul lipit din blocurile `text`). 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. Î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.
