Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

JSON garanterat av schema

Lektion 1 av 12 Uppdaterad 28 juli 2026 Utvecklare
På denna sida
  1. Varför strukturerade utdata förändrar allt
  2. Hur det fungerar
  3. Tillgänglighet
  4. Utan kontra med strukturerade utdata
  5. Två tillgängliga metoder
  6. Viktiga punkter

Varför strukturerade utdata förändrar allt

När du använder en språkmodell i produktion behöver du svar som din kod kan hantera. Inte fritext, inte ungefärlig JSON – utan JSON som är garanterat kompatibel med ett schema du definierar. Det är precis vad Grok API:s strukturerade utdata erbjuder dig.

Principen är enkel: du tillhandahåller ett JSON-schema till modellen, och API:t garanterar att svaret följer denna struktur exakt. Inget slumpmässigt parsande, inga bräckliga regex-uttryck, inga try/catch-block för att hantera fall där modellen hittar på ett eget format.

Hur det fungerar

Strukturerade utdata förlitar sig på en begränsningsmekanism som tillämpas under genereringen av texten. Vid varje token som produceras tvingas modellen att endast generera token som är kompatibla med det angivna schemat. Resultatet: JSON som alltid är giltig och alltid kompatibel.

Låt oss titta på ett konkret exempel. Du vill extrahera kontaktinformation från ett e-postmeddelande:

from pydantic import BaseModel

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

# Svaret kommer ALLTID att vara ett giltigt Contact-objekt

Utan strukturerade utdata kan modellen returnera telefonnumret som "tel", "phone" eller "numéro". Med ett schema kommer fältet alltid att heta telephone, och dess värde kommer alltid att vara en sträng eller null.

Tillgänglighet

Strukturerade utdata stöds på alla xAI:s språkmodeller: Grok 4.5, Grok 4.3, grok-4.20-varianter och senare versioner. Oavsett vilken modell du använder är funktionen tillgänglig utan extra kostnad eller ytterligare konfiguration.

100%
Garanterat giltig JSON
7
Stödda typer
Alla
xAI-modeller
2
Anropsmetoder

Utan kontra med strukturerade utdata

Här ser du vad du får utan och med denna funktion:

Utan strukturerade utdata:

  • Modellen kan returnera fritext, ofullständig JSON eller ett oväntat format
  • Du måste parsar manuellt och hantera fel
  • Fältnamn kan variera från en begäran till en annan
  • Din pipeline kraschar så fort modellen ändrar format

Med strukturerade utdata:

  • JSON:en är alltid syntaktiskt giltig
  • Strukturen matchar det angivna schemat exakt
  • Datatyper respekteras (sträng, tal, booleskt värde, etc.)
  • Din kod kan konsumera svaret direkt

Två tillgängliga metoder

Grok API erbjuder två metoder för att använda strukturerade utdata:

  • parse(): Automatisk metod som returnerar ett typat objekt direkt. Idealiskt för de flesta fall.
  • response_format: Manuell metod som returnerar en JSON-sträng. Ger mer kontroll, men du måste själv hantera parsningen.

Du kommer att utforska dessa två metoder i detalj i de kommande lektionerna.

Viktiga punkter

  • Strukturerade utdata garanterar JSON som är kompatibel med ditt schema vid varje anrop
  • Begränsningen tillämpas under genereringen, inte efteråt
  • Alla xAI:s språkmodeller stöder denna funktion
  • Två metoder finns tillgängliga: parse() (automatisk) och response_format (manuell)
  • Detta är grunden för varje pålitlig produktionspipeline med Grok API