Spring til hovedindhold
Dansk— Vælg et sprog
Menu

JSON garanteret af skema

Lektion 1 af 12 Opdateret 28. juli 2026 Udvikler
På denne side
  1. Hvorfor strukturerede output ændrer alt
  2. Hvordan det virker
  3. Tilgængelighed
  4. Uden kontra med strukturerede output
  5. To tilgængelige tilgange
  6. Vigtige pointer

Hvorfor strukturerede output ændrer alt

Når du bruger en sprogmodel i produktion, har du brug for svar, som din kode kan anvende direkte. Ikke fritekst, ikke approksimativ JSON – men JSON, der er garanteret kompatibel med et skema, du definerer. Det er præcis, hvad Grok API’s strukturerede output tilbyder dig.

Princippet er simpelt: Du leverer et JSON-skema til modellen, og API’en garanterer, at svaret vil følge denne struktur nøjagtigt. Ingen tilfældig parsing, ingen skrøbelige regulære udtryk, ingen try/catch-blokke for at håndtere tilfælde, hvor modellen finder på et eget format.

Hvordan det virker

Strukturerede output baserer sig på en begrænsningsmekanisme, der anvendes under genereringen af teksten. Ved hvert enkelt token, der produceres, begrænses modellen til kun at generere tokens, der er kompatible med det angivne skema. Resultatet er JSON, der altid er gyldig og altid overholder reglerne.

Lad os se på et konkret eksempel. Du ønsker at udtrække kontaktoplysninger fra en e-mail:

from pydantic import BaseModel

class Contact(BaseModel):
    nom: str
    email: str
    entreprise: str
    telephone: str | None

# Svaret vil ALTID være et gyldigt Contact-objekt

Uden strukturerede output kunne modellen returnere telefonnummeret som "tel", "phone" eller "numéro". Med et skema vil feltet altid hedde telephone, og værdien vil altid være en streng eller null.

Tilgængelighed

Strukturerede output understøttes på alle xAI-sprogmodeller: Grok 4.5, Grok 4.3, grok-4.20-varianter og senere versioner. Uanset hvilken model du bruger, er funktionen tilgængelig uden ekstra omkostninger eller yderligere konfiguration.

100%
Garanteret gyldig JSON
7
Understøttede typer
Alle
xAI-modeller
2
Kaldemetoder

Uden kontra med strukturerede output

Her er forskellen på at bruge funktionen eller ej:

Uden strukturerede output:

  • Modellen kan returnere fritekst, delvis JSON eller et uventet format
  • Du skal parse manuelt og håndtere fejl
  • Feltnavne kan variere fra én anmodning til en anden
  • Din pipeline bryder sammen, så snart modellen ændrer format

Med strukturerede output:

  • JSON’en er altid syntaktisk gyldig
  • Strukturen matcher det angivne skema nøjagtigt
  • Typer overholdes (streng, tal, boolean osv.)
  • Din kode kan forbruge svaret direkte

To tilgængelige tilgange

Grok API tilbyder to metoder til at bruge strukturerede output:

  • parse(): Automatisk metode, der returnerer et typet objekt direkte. Ideel til de fleste tilfælde.
  • response_format: Manuel metode, der returnerer en JSON-streng. Giver mere kontrol, men kræver at du selv parser svaret.

Du vil opdage disse to metoder i detaljer i de kommende lektioner.

Vigtige pointer

  • Strukturerede output garanterer JSON, der overholder dit skema ved hver eneste kald
  • Begrænsningen anvendes under genereringen, ikke bagefter
  • Alle xAI-sprogmodeller understøtter denne funktion
  • To metoder er tilgængelige: parse() (automatisk) og response_format (manuel)
  • Dette er fundamentet for enhver pålidelig produktionspipeline med Grok API