...
Eroare Aplicații AI cu LLM · JSON de la model

json.decoder.JSONDecodeError: Unterminated string starting at: line 1 column 95 (char 94)

Pe scurt

JSON-ul de la model e tăiat la mijloc: răspunsul s-a oprit la `max_tokens` (`stop_reason == "max_tokens"`) înainte să închidă ghilimelele și acoladele. Mărește `max_tokens`, verifică `stop_reason` înainte de `json.loads` și cere câmpuri mai scurte.

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

Ce înseamnă

Unterminated string starting at înseamnă că parserul a găsit ghilimelele de deschidere ale unui șir la poziția indicată, dar textul s-a terminat înainte de ghilimelele de închidere. Variantele Expecting ',' delimiter sau Expecting value la finalul textului au aceeași cauză: JSON incomplet.

Cu LLM-urile, JSON-ul incomplet are aproape mereu o singură cauză: limita de tokeni. Modelul scrie răspunsul token cu token și se oprește când atinge max_tokens, chiar dacă e la mijlocul unui cuvânt. Răspunsul primit are atunci stop_reason == "max_tokens" (la OpenAI Responses: status == "incomplete"), iar textul se oprește brusc.

Se întâmplă mai ales la extragerea din documente lungi, la liste cu multe elemente sau când ai pus o limită mică ca să economisești. Ieșirea structurată nu te salvează aici: dacă tokenii se termină, JSON-ul rămâne neterminat. Verifică stop_reason înainte să parsezi.

De ce apare: cauzele frecvente

1max_tokens prea mic pentru răspunsul cerut

Greșit
PYTHON
r = client.messages.create(model=MODEL, max_tokens=40, messages=mesaje)
date = json.loads(r.content[0].text)
Corect
PYTHON
r = client.messages.create(model=MODEL, max_tokens=500, messages=mesaje)
if r.stop_reason == "max_tokens":
    raise ValueError("Răspuns tăiat: mărește max_tokens")
date = json.loads(r.content[0].text)

Cu o limită potrivită, JSON-ul se termină. Verificarea stop_reason îți spune clar ce s-a întâmplat, în loc de o eroare de parsare.

2Listă lungă cerută într-un singur răspuns

Greșit
PYTHON
prompt = "Extrage toate cele 300 de produse din catalog în JSON."
Corect
PYTHON
for bucata in bucati(catalog, 30):
    prompt = "Extrage produsele din textul de mai jos în JSON:\n" + bucata

Împărțit în bucăți, fiecare răspuns e destul de scurt ca să încapă în limită.

3Câmpuri text lungi, fără limită în instrucțiuni

Greșit
PYTHON
system = "Extrage datele facturii în JSON."
Corect
PYTHON
system = "Extrage datele facturii în JSON. Câmpul observatii are cel mult 15 cuvinte."

Câmpurile libere pot crește mult. O limită clară de lungime ține răspunsul mic și previzibil.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos extrage datele unei facturi și dă JSONDecodeError: Unterminated string ...: cu max_tokens=50, răspunsul se oprește la mijlocul JSON-ului. Repară programul: mărește limita la 400 de tokeni și, înainte de json.loads, afișează Răspuns tăiat, mărește max_tokens și oprește-te dacă stop_reason este max_tokens. Programul afișează stop_reason: ..., furnizorul și totalul.

Codul care dă eroarea
PYTHON
import json

import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()

raspuns = client.messages.create(
    model=MODEL,
    max_tokens=50,
    system="Extragi datele facturii în JSON cu cheile furnizor, numar, total, observatii.",
    messages=[{"role": "user", "content": "Factura EF-2026-0815 de la Electrica, total 248,50 lei, consum octombrie."}],
)
print("stop_reason:", raspuns.stop_reason)
date = json.loads(raspuns.content[0].text)
print("Furnizor:", date["furnizor"])
print("Total:", date["total"])
După reparație, programul afișează
stop_reason: end_turn
Furnizor: Electrica Furnizare SA
Total: 248.5
Indiciu

Citește raspuns.stop_reason înainte de json.loads.

Alte forme ale mesajului

  • json.decoder.JSONDecodeError: Expecting ',' delimiter: line 1 column 120 (char 119)
  • json.decoder.JSONDecodeError: Unterminated string starting at: line 1 column 13 (char 12)

Cum o eviți pe viitor

  • Verifică mereu stop_reason (Claude) sau status (OpenAI) înainte de json.loads.
  • Pune max_tokens cu marjă față de răspunsul așteptat; plătești doar ce se generează, nu limita.
  • Împarte documentele lungi în bucăți și cere câmpuri scurte.
  • Loghează răspunsurile tăiate, ca să ajustezi limita din date reale.

Întrebări frecvente

De ce nu mi-a dat API-ul o eroare?

Pentru că, din punctul de vedere al API-ului, totul a mers: modelul a generat exact câți tokeni i-ai permis. Semnalul e stop_reason == "max_tokens", nu o excepție.

Pot continua răspunsul tăiat?

Pentru text liber, poți cere continuarea într-un mesaj nou. Pentru JSON e mai simplu și mai sigur să repeți cererea cu un max_tokens mai mare.

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.