~/tools / Structured Output Schema Checker
Structured Output Schema Checker — Verifica uno JSON Schema rispetto ai limiti di OpenAI, Anthropic e Gemini
Verifica uno JSON Schema rispetto ai limiti documentati degli output strutturati di OpenAI, Anthropic e Gemini. Scopri quali parole chiave sono non accettate, ignorate o non documentate prima di inviare lo schema all'API. Nulla lascia il tuo browser.
Regole verificate sulla documentazione di ciascun fornitore il 2026-10-23.
Non controllati: la profondità di annidamento, il limite sugli enum lunghi e tutto ciò che i fornitori non documentano. I fornitori cambiano queste regole, quindi verifica sulla documentazione aggiornata.
Tutto viene eseguito nel tuo browser. Lo schema non viene caricato.
Le API di IA possono obbligare la risposta di un modello a seguire uno JSON Schema, ma ogni fornitore accetta soltanto una parte di JSON Schema, e le parti differiscono. Uno schema che funziona con un fornitore può essere rifiutato da un altro, oppure accettato mentre alcune sue regole vengono scartate senza avviso. Questo strumento legge il tuo schema e lo confronta con quanto afferma la documentazione di ciascun fornitore: regole obbligatorie come additionalProperties impostato su false, parole chiave non supportate, parole chiave accettate ma non applicate e limiti di dimensione pubblicati. I risultati sono suddivisi in tre tipi, così puoi distinguere un errore documentato da una parola chiave che la documentazione semplicemente non elenca. Le regole sono state verificate sulla documentazione dei fornitori alla data indicata sotto lo strumento.
Casi d'uso
- Controllare uno schema prima di inviarlo come richiesta di output strutturato, per non scoprire il problema da un errore 400
- Individuare quali parole chiave devi spostare dallo schema al tuo codice di validazione
- Confrontare ciò che OpenAI, Anthropic e Gemini accettano per lo stesso schema
Utilizzo
- Incolla lo JSON Schema che intendi inviare, oppure carica l'esempio.
- Leggi il risultato per ogni fornitore. Non accettato significa che la documentazione dice che lo schema fallirà o che va modificato. Ignorato significa che la parola chiave è accettata ma non applicata. Non documentato significa che la parola chiave manca dall'elenco delle parole chiave supportate dal fornitore.
- Correggi ciò che è contrassegnato come Non accettato e verifica il resto con una richiesta reale.
FAQ
Un risultato senza problemi significa che l'API accetterà il mio schema?
No. Lo strumento controlla le regole che i fornitori documentano. Non chiama nessuna API e la documentazione non copre tutto, quindi uno schema può comunque essere rifiutato. Considera un risultato senza problemi come "nessun problema noto" e prova con una richiesta reale.
Che cosa significano Non accettato, Ignorato e Non documentato?
Non accettato: la documentazione dice che la parola chiave non è supportata oppure che una regola va rispettata, per esempio additionalProperties deve essere false. Ignorato: la documentazione dice che la parola chiave è accettata ma non applicata, quindi il modello può violarla. Non documentato: la parola chiave non è nell'elenco delle parole chiave supportate dal fornitore, quindi può essere rifiutata o ignorata e la documentazione non dice quale delle due cose.
Perché OpenAI richiede che ogni proprietà sia required?
Nella modalità strict OpenAI richiede che tutte le proprietà siano elencate in required e che additionalProperties sia false. Per rendere facoltativo un campo, la documentazione indica di usare un'unione con null, per esempio un type di ["string", "null"].
Il mio schema usa minimum, maxLength o simili. Che cosa devo fare?
Anthropic non supporta i vincoli numerici né i limiti di lunghezza delle stringhe, e Gemini non applica i limiti di lunghezza. Rimuovili dallo schema, descrivi il limite nel campo description e controlla tu stesso il valore dopo che la risposta è arrivata. Lo strumento JSON Schema Validator può eseguire questo controllo.
Questo strumento controlla la ricorsione?
Sì, per Anthropic, la cui documentazione elenca gli schemi ricorsivi tra quelli non supportati. OpenAI e Gemini documentano gli schemi ricorsivi, quindi non vengono segnalati.
Che cosa non viene controllato?
La profondità di annidamento, il limite sugli enum lunghi e tutto ciò che i fornitori non documentano. Lo strumento inoltre non conosce i modelli più recenti né le funzionalità aggiunte dopo la data del controllo, quindi, quando conta, verifica sulla documentazione aggiornata.
Il mio schema viene inviato a un server?
No. Il controllo viene eseguito nel tuo browser.