Salt la conținutul principal
Română— Alege o limbă
Meniu

JSON garantat de schemă

Lecția 1 din 12 Actualizată 28 iulie 2026 Dezvoltator
Pe această pagină
  1. De ce ieșirile structurate schimbă totul
  2. Cum funcționează
  3. Disponibilitate
  4. Fără vs. Cu ieșiri structurate
  5. Două abordări disponibile
  6. Puncte cheie

De ce ieșirile structurate schimbă totul

Când utilizați un model lingvistic în producție, aveți nevoie de răspunsuri pe care codul le poate utiliza direct. Nu text liber, nu JSON aproximativ, ci JSON garantat conform cu o schemă definită de dumneavoastră. Exact asta oferă ieșirile structurate ale API-ului Grok.

Principiul este simplu: furnizați modelului o schemă JSON, iar API-ul garantează că răspunsul va respecta această structură exact. Fără analiză haotică, fără expresii regulate fragile, fără blocuri try/catch pentru a gestiona cazurile în care modelul inventează un format.

Cum funcționează

Ieșirile structurate se bazează pe un mecanism de constrângere aplicat în timpul generării textului. La fiecare token produs, modelul este constrâns să genereze doar token-uri compatibile cu schema furnizată. Rezultatul: un JSON care este întotdeauna valid, întotdeauna conform.

Să analizăm un exemplu concret. Doriți să extrageți informații de contact dintr-un e-mail:

from pydantic import BaseModel

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

# Răspunsul va fi ÎNTOTDEAUNA un obiect Contact valid

Fără ieșiri structurate, modelul ar putea returna numărul de telefon sub cheia "tel", "phone" sau "numéro". Cu o schemă, câmpul se va numi întotdeauna telephone, iar valoarea sa va fi mereu un șir de caractere sau null.

Disponibilitate

Ieșirile structurate sunt suportate pe toate modelele lingvistice xAI: Grok 4.5, Grok 4.3, variantele grok-4.20 și versiunile ulterioare. Indiferent de modelul pe care îl utilizați, funcționalitatea este disponibilă fără costuri suplimentare sau configurare adițională.

100%
JSON garantat valid
7
Tipuri suportate
Toate
Modelele xAI
2
Metode de apel

Fără vs. Cu ieșiri structurate

Iată ce obțineți fără și cu această funcționalitate:

Fără ieșiri structurate:

  • Modelul poate returna text liber, JSON parțial sau un format neașteptat
  • Trebuie să analizați manual și să gestionați erorile
  • Numele câmpurilor pot varia de la o cerere la alta
  • Fluxul dumneavoastră se întrerupe imediat ce modelul schimbă formatul

Cu ieșiri structurate:

  • JSON-ul este întotdeauna valid din punct de vedere sintactic
  • Structura corespunde exact schemei furnizate
  • Tipurile de date sunt respectate (șir, număr, boolean etc.)
  • Codul dumneavoastră poate consuma răspunsul direct

Două abordări disponibile

API-ul Grok oferă două metode pentru utilizarea ieșirilor structurate:

  • parse(): Metodă automată care returnează direct un obiect tipizat. Ideală pentru majoritatea cazurilor.
  • response_format: Metodă manuală care returnează un șir JSON. Oferă mai mult control, dar analiza revine dumneavoastră.

Veți descoperi aceste două metode în detaliu în lecțiile următoare.

Puncte cheie

  • Ieșirile structurate garantează un JSON conform cu schema dumneavoastră la fiecare apel
  • Constrângerea este aplicată în timpul generării, nu după
  • Toate modelele lingvistice xAI suportă această funcționalitate
  • Sunt disponibile două metode: parse() (automat) și response_format (manual)
  • Aceasta este fundația oricărui flux de producție fiabil cu API-ul Grok