---
title: "Cos’è la JSON mode? json_object e json_schema a confronto"
description: "La JSON mode rende la risposta di un LLM JSON valido ma non impone alcuno schema. Come funziona response_format json_object e quando usare gli structured output."
url: https://broadrouter.com/it/glossary/json-mode/
lang: it
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/glossary/json-mode/) (aggiornato il 2026-11-14).

# JSON mode (modalità JSON)

Aggiornato 2026-11-14

La JSON mode è un’impostazione delle API LLM, response\_format {"type": "json\_object"} nelle API in stile OpenAI, che rende la risposta del modello JSON valido e analizzabile. A differenza degli structured output con un JSON Schema, non garantisce quali chiavi, tipi o valori contenga l’oggetto.

Detto anche: modalità JSON, output JSON, risposta in JSON, JSON mode, json\_object, JSON output mode, JSON response mode

La JSON mode risponde a una domanda: `json.loads()` andrà a buon fine? Non risponde alla seconda: è l’oggetto che il mio codice si aspetta?

## Come funziona

Nella Chat Completions API la attivi con un solo campo:

```json
{"response_format": {"type": "json_object"},
 "messages": [
   {"role": "system", "content": "Return JSON with keys name and email."},
   {"role": "user", "content": "Reach me at Sara, sara@example.com"}]}
```

Il riferimento API di OpenAI la chiama “the older JSON mode, which ensures the message the model generates is valid JSON” (traduzione: la vecchia JSON mode, che garantisce che il messaggio generato dal modello sia JSON valido). Porta con sé due regole. Devi chiedere JSON in un messaggio: la guida di OpenAI dice che l’API “will throw an error if the string ‘JSON’ does not appear somewhere in the context” (traduzione: restituirà un errore se la stringa ‘JSON’ non compare da qualche parte nel contesto). E la forma la decide il modello. La guida afferma che la JSON mode “will not guarantee the output matches any specific schema” (traduzione: non garantisce che l’output corrisponda a uno schema specifico).

L’[output strutturato](https://broadrouter.com/it/glossary/structured-output/) è l’opzione più rigorosa. Passa un JSON Schema con `{"type": "json_schema", ...}` e il modello è vincolato a rispettarlo.

|  | JSON mode (`json_object`) | Structured output (`json_schema`) |
| --- | --- | --- |
| JSON valido | sì | sì |
| Chiavi e tipi obbligatori | no | sì |
| Fornisci tu uno schema | no | sì |
| Devi citare “JSON” nel prompt | sì (OpenAI) | no |

OpenAI consiglia di “always using Structured Outputs instead of JSON mode when possible” (traduzione: usare sempre gli Structured Outputs al posto della JSON mode quando possibile).

## Perché è importante

-   **La validazione resta a te.** Con la JSON mode, una chiave mancante o un numero inviato come stringa superano il parsing e falliscono più avanti. Valida contro uno schema nel codice.
-   **Troncamento.** Se la risposta arriva a [`max_tokens`](https://broadrouter.com/it/glossary/max-tokens/), il JSON è incompleto. I modelli di ragionamento sono più esposti, perché il ragionamento consuma lo stesso budget.
-   **Ripiego.** La guida di OpenAI indica la JSON mode per i modelli più vecchi in cui `json_schema` non è disponibile. Il supporto varia per provider e modello, quindi JSON mode più la tua validazione è il ripiego quando uno schema non viene accettato.

## Su BroadNet Inference

Il [riferimento API](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-json-mode&utm_content=body#models) di BroadNet indica l’output strutturato per GLM 5.3 e Qwen3.8 27B. Non dice se il `response_format` supportato sia `json_object` o `json_schema`, né se DeepSeek V4.1 Flash e BroadNet Gemma 4 VL 26B accettino l’uno o l’altro. Provali entrambi sul tuo modello. Per scrivere lo schema usa il [generatore di JSON Schema](https://broadrouter.com/tools/json-schema-generator/). L’articolo [JSON mode o json\_schema](https://broadrouter.com/it/blog/structured-output-json-schema/) tratta riparazione e monitoraggio, e la [guida alle fatture](https://broadrouter.com/it/guides/read-arabic-invoices-with-vision/) mostra l’estrazione di JSON da immagini.

## Domande frequenti

### La JSON mode è la stessa cosa degli structured output?

No. La guida di OpenAI dice che entrambi producono JSON valido, ma solo gli Structured Outputs garantiscono il rispetto dello schema. La JSON mode può restituire qualsiasi oggetto valido.

### Perché la JSON mode dà un errore sulla parola JSON?

OpenAI richiede che da qualche parte nei messaggi ci sia l’istruzione di produrre JSON e restituisce un errore se la stringa "JSON" non compare nel contesto.

### La JSON mode può comunque restituire JSON rotto?

Sì, se la risposta viene troncata da max\_tokens o dal limite di contesto. Controlla finish\_reason prima del parsing.

## Vedi anche

-   [Output strutturato (structured output)](https://broadrouter.com/it/glossary/structured-output/) (termine)
-   [Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/) (termine)
-   [max\_tokens](https://broadrouter.com/it/glossary/max-tokens/) (termine)
-   [System prompt (prompt di sistema)](https://broadrouter.com/it/glossary/system-prompt/) (termine)
-   [API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) (termine)
-   [JSON Schema](https://broadrouter.com/it/glossary/json-schema/) (termine)
-   [Leggere fatture e scontrini in arabo con un modello vision](https://broadrouter.com/it/guides/read-arabic-invoices-with-vision/) (guida)
-   [Usare l’SDK Python di OpenAI con BroadNet Inference](https://broadrouter.com/it/guides/openai-python-sdk/) (guida)
-   [JSON mode o json\_schema: output strutturato che regge in produzione](https://broadrouter.com/it/blog/structured-output-json-schema/) (articolo)
-   [Estrarre dati da fatture, scontrini e moduli in JSON con un LLM vision](https://broadrouter.com/it/blog/extract-data-from-documents-with-vision-llm/) (articolo)
-   [JSON non valido da un LLM: cause, riparazione e retry](https://broadrouter.com/it/blog/fix-invalid-json-from-llm/) (articolo)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-json-mode&utm_content=page-cta) ·

**Fonti**

-   [OpenAI, guida agli Structured Outputs (JSON mode e Structured Outputs a confronto)](https://developers.openai.com/api/docs/guides/structured-outputs)
-   [Riferimento API di OpenAI, creare una chat completion (response\_format)](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Riferimento API di BroadNet Inference, ID dei modelli (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-json-mode&utm_content=sources#models)
