JSON gegarandeerd door schema
Op deze pagina
Waarom gestructureerde uitvoer alles verandert
Wanneer u een taalmodel in productie gebruikt, heeft u antwoorden nodig die code可以直接 verwerken. Geen vrije tekst, geen benaderend JSON—maar JSON dat gegarandeerd conform is aan een schema dat u definieert. Dat is precies wat Grok API gestructureerde uitvoer u biedt.
Het principe is eenvoudig: u levert een JSON-schema aan het model en de API garandeert dat het antwoord deze structuur exact volgt. Geen willekeurig parsen, geen fragiele regex, geen try/catch-blokken om gevallen af te handelen waarin het model een eigen formaat bedenkt.
Hoe het werkt
Gestructureerde uitvoer berust op een beperkingsmechanisme dat wordt toegepast tijdens de generatie van de tekst. Bij elke gegenereerde token is het model beperkt tot het produceren van alleen tokens die compatibel zijn met het opgegeven schema. Het resultaat: JSON die altijd geldig en altijd conform is.
Laten we kijken naar een concreet voorbeeld. U wilt contactinformatie uit een e-mail extraheren:
from pydantic import BaseModel
class Contact(BaseModel):
nom: str
email: str
entreprise: str
telephone: str | None
# Het antwoord is ALTIJD een geldig Contact-object
Zonder gestructureerde uitvoer zou het model het telefoonnummer kunnen retourneren als "tel", "phone" of "numéro". Met een schema heet het veld altijd telephone en is de waarde altijd een string of null.
Beschikbaarheid
Gestructureerde uitvoer wordt ondersteund op alle xAI-taalmodellen: Grok 4.5, Grok 4.3, grok-4.20-varianten en latere versies. Welk model u ook gebruikt, de functie is beschikbaar zonder extra kosten of aanvullende configuratie.
Zonder versus met gestructureerde uitvoer
Dit is wat u krijgt zonder en met deze functie:
Zonder gestructureerde uitvoer:
- Het model kan vrije tekst, gedeeltelijke JSON of een onverwacht formaat retourneren
- U moet handmatig parsen en fouten afhandelen
- Veldnamen kunnen per verzoek variëren
- Uw pipeline breekt zodra het model van formaat verandert
Met gestructureerde uitvoer:
- De JSON is altijd syntactisch geldig
- De structuur komt exact overeen met het opgegeven schema
- Typen worden gerespecteerd (string, getal, boolean, enz.)
- Uw code kan het antwoord direct verwerken
Twee beschikbare benaderingen
De Grok API biedt twee methoden om gestructureerde uitvoer te gebruiken:
parse(): Automatische methode die direct een getypt object retourneert. Ideaal voor de meeste gevallen.response_format: Handmatige methode die een JSON-string retourneert. Biedt meer controle, maar u moet zelf parsen.
U ontdekt deze twee methoden in detail in de komende lessen.
Belangrijkste punten
- Gestructureerde uitvoer garandeert bij elke aanroep JSON die conform uw schema is
- De beperking wordt tijdens de generatie toegepast, niet achteraf
- Alle xAI-taalmodellen ondersteunen deze functie
- Er zijn twee methoden beschikbaar:
parse()(automatisch) enresponse_format(handmatig) - Dit vormt de basis van elke betrouwbare productiepipeline met de Grok API