ValueError: Invalid format specifier ' "Ana"' for object of type 'str'
Ai pus un exemplu JSON direct într-un f-string, iar Python a citit {"nume": "Ana"} ca expresia "nume" urmată de specificatorul de format "Ana". Dublează acoladele exemplului în f-string ({{ și }}) sau adaugă exemplul JSON separat, fără f-string.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Într-un f-string, tot ce e între acolade se evaluează ca expresie Python, iar ce urmează după : e un specificator de format (de exemplu {pret:.2f}). Pentru {"nume": "Ana"}, Python evaluează textul "nume", apoi încearcă să-l formateze cu specificatorul "Ana", care nu înseamnă nimic. De aici mesajul, care arată exact specificatorul respins și tipul valorii.
Eroarea apare când construiești prompturi cu f-string-uri și pui în ele un exemplu de răspuns JSON. Variante: NameError, dacă în acolade e un cuvânt fără ghilimele ({nume}), sau exemplul apare greșit în prompt fără nicio eroare.
În versiunile mai vechi de Python, mesajul e mai scurt: Invalid format specifier.
De ce apare: cauzele frecvente
1Exemplu JSON într-un f-string
prompt = f'Răspunde ca JSON: {"nume": "Ana"}. Mesaj: {mesaj}'prompt = f'Răspunde ca JSON: {{"nume": "Ana"}}. Mesaj: {mesaj}'{{ și }} produc acolade literale, iar {mesaj} rămâne expresie.
2Exemplu lung amestecat cu variabile
prompt = f"""Formatul: {"nume": "...", "total": 0}
Factura: {text}"""EXEMPLU = '{"nume": "...", "total": 0}'
prompt = "Formatul: " + EXEMPLU + "\nFactura: " + textExemplul ține într-o constantă normală, fără f-string, deci acoladele nu mai sunt evaluate.
Repară eroarea, direct în pagină
Promptul pentru extragerea datelor din facturi e construit cu un f-string care conține un exemplu JSON, iar programul cade cu ValueError: Invalid format specifier .... Repară f-string-ul, ca exemplul să apară cu acolade simple în prompt, și afișează furnizorul și totalul extrase.
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
factura = "Furnizor: Electrica Nord SRL. Total de plată: 245,30 lei."
prompt = f'Extrage datele ca JSON: {"furnizor": "...", "total": 0}\nFactura: {factura}'
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}])
date = json.loads(r.content[0].text)
print("Furnizor:", date["furnizor"])
print("Total:", date["total"], "lei")Furnizor: Electrica Nord SRL Total: 245.3 lei
Indiciu
În f-string, acoladele exemplului se scriu {{ și }}; {factura} rămâne simplu.
Reparația
import json
import anthropic
MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic()
factura = "Furnizor: Electrica Nord SRL. Total de plată: 245,30 lei."
prompt = f'Extrage datele ca JSON: {{"furnizor": "...", "total": 0}}\nFactura: {factura}'
r = client.messages.create(model=MODEL, max_tokens=200, messages=[{"role": "user", "content": prompt}])
date = json.loads(r.content[0].text)
print("Furnizor:", date["furnizor"])
print("Total:", date["total"], "lei")De ce merge
În f-string, {"furnizor": "..."} e evaluat ca expresie cu specificator de format, de unde eroarea. Cu acolade dublate, Python le scrie literal, iar exemplul JSON ajunge corect în prompt. Doar {factura} rămâne expresie și e înlocuit cu textul facturii, iar modelul răspunde în formatul cerut.
Alte forme ale mesajului
ValueError: Invalid format specifierValueError: Invalid format specifier ' "...", "email": "..."' for object of type 'str'NameError: name 'nume' is not defined
Cum o eviți pe viitor
- Nu pune exemple JSON sau cod direct în f-string-uri; ține-le în constante separate.
- Dacă le pui, dublează fiecare acoladă care nu e o expresie.
- Pentru JSON garantat, folosește ieșirea structurată cu schemă în loc de un exemplu în text.
- Afișează promptul final o dată, ca să vezi exact ce primește modelul.
Întrebări frecvente
De ce mesajul conține „for object of type 'str'”?
Pentru că expresia evaluată a fost textul "nume", adică un str, iar specificatorul de după : nu e valid pentru texte.
Pot folosi json.dumps într-un f-string?
Da: f"Format: {json.dumps(EXEMPLU)}" e corect, pentru că acoladele conțin o expresie validă, iar rezultatul ei e textul JSON.
Erori înrudite
KeyError: '"nume"' Șablonul promptului conține un exemplu JSON cu acolade, iar str.format() crede că {"nume": ...} e un câmp de completat. Dublează acoladele din exemplu ({{ și }}) sau construiește promptul fără format(), de exemplu cu concatenare sau string.Template. ValueError: Single '}' encountered in format string Șablonul de prompt are o acoladă singură care nu face parte dintr-un câmp: de obicei ai dublat acolada de deschidere a unui exemplu JSON ({{), dar nu și pe cea de închidere. Dublează fiecare acoladă de text: {{ și }}. 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`. Î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.
