Generatore di JSON Schema per l'output strutturato
Incolla un JSON di esempio, ottieni un JSON Schema e copia una richiesta API che fa restituire al modello esattamente quella struttura. Tutto funziona nel tuo browser.
Ogni proprietà è required, additionalProperties è false e i campi mancanti in alcuni elementi diventano nullable. L'output strutturato strict si aspetta esattamente questo.
Il tuo JSON viene elaborato in questo browser e non viene mai caricato.
Impostazioni della richiesta (modello, prompt)
Modello di esempio. Il supporto di json_schema varia in base al modello, quindi controlla la pagina del modello prima di farci affidamento.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "response",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"age": {
"type": "integer"
},
"email": {
"type": "string",
"format": "email"
},
"joined": {
"type": "string",
"format": "date-time"
},
"skills": {
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"zip": {
"type": "string"
}
},
"required": [
"city",
"zip"
],
"additionalProperties": false
}
},
"required": [
"name",
"age",
"email",
"joined",
"skills",
"address"
],
"additionalProperties": false
}Eseguilo su HiAPI in tre passi
- 01Crea un account gratuito
Registrati con e-mail, Google o GitHub. Ci vuole circa un minuto.
Registrati - 02Crea una chiave API
Genera una chiave nella dashboard e usala al posto di YOUR_API_KEY.
Ottieni una chiave API - 03Fai la tua prima chiamata
Esegui il codice generato. La tua richiesta appare nei log di utilizzo.
Come generare uno schema per l'output strutturato
- 01 Incolla un JSON di esempio
Usa un esempio reale dell'output desiderato, con valori rappresentativi. Includi diversi elementi nell'array in modo che vengano rilevati i campi opzionali.
- 02 Rivedi lo schema
Controlla tipi e formati e ritocca i nomi. La modalità strict rende ogni campo obbligatorio, che è ciò che si aspetta l'output strutturato strict.
- 03 Copia la chiamata API
Scegli cURL, Python o Node.js, aggiungi la tua chiave ed esegui. Il risultato è una stringa JSON in choices[0].message.content.
FAQ sul generatore di JSON Schema
Il mio JSON viene caricato da qualche parte?
No. Schema e codice vengono generati interamente nel tuo browser. Niente viene inviato a HiAPI o ad altri server.
Cosa cambia la modalità strict?
Segna ogni proprietà come required, imposta additionalProperties su false e trasforma in tipi nullable i campi mancanti in alcuni elementi dell'array. L'output strutturato strict richiede tutto questo.
Ogni modello supporta json_schema?
No. Il supporto dipende dal modello. L'esempio usa kimi-k3 con response_format.type impostato su json_schema. Controlla la pagina del modello per sapere cosa accetta ciascuno.
Come viene dedotto lo schema da un solo esempio?
I tipi derivano dai tuoi valori, interi e decimali vengono distinti, gli array vengono uniti tra gli elementi e i formati di stringa vengono aggiunti quando ogni campione corrisponde. Un singolo esempio non può mostrare enum o limiti di valore, quindi modificali a mano.
Dove si trova il risultato strutturato nella risposta?
In choices[0].message.content come stringa JSON. Analizzala e convalida i campi di business nella tua applicazione.