Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

JSON zajamčen shemom

Lekcija 1 od 12 Ažurirano 28. srpnja 2026. Programer
Na ovoj stranici
  1. Zašto strukturirani izlazi mijenjaju sve
  2. Kako to funkcionira
  3. Dostupnost
  4. Bez naspram sa strukturiranim izlazima
  5. Dva dostupna pristupa
  6. Ključne točke

Zašto strukturirani izlazi mijenjaju sve

Kada koristiš jezični model u proizvodnji, trebaju ti odgovori koje tvoj kod može izravno koristiti. Ne slobodan tekst, ne približan JSON – već JSON zajamčeno usklađen sa shemom koju ti definiraš. Upravo to ti nudi Grok API sa svojim strukturiranim izlazima.

Princip je jednostavan: modelu dostaviš JSON shemu, a API jamči da će odgovor točno slijediti tu strukturu. Nema nasumičnog parsiranja, nema krhkih regularnih izraza, nema blokova try/catch za rukovanje slučajevima gdje model izmisli vlastiti format.

Kako to funkcionira

Strukturirani izlazi oslanjaju se na mehanizam ograničenja primijenjen tijekom generiranja teksta. Pri svakom proizvedenom tokenu, model je ograničen tako da generira isključivo tokene kompatibilne s dostavljenom shemom. Rezultat? JSON koji je uvijek valjan i uvijek usklađen.

Pogledajmo konkretan primjer. Želiš izvući kontakt podatke iz e-pošte:

from pydantic import BaseModel

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

# Odgovor će UVJEK biti valjan objekt Contact

Bez strukturiranih izlaza, model bi mogao vratiti telefonski broj pod ključem "tel", "phone" ili "numéro". Uz shemu, polje će se uvijek zvati telephone, a njegova vrijednost bit će uvijek niz znakova ili null.

Dostupnost

Strukturirani izlazi podržani su na svim jezičnim modelima tvrtke xAI: Grok 4.5, Grok 4.3, varijante grok-4.20 i novije verzije. Koji god model koristio, značajka je dostupna bez dodatnih troškova ili konfiguracije.

100%
Zajamčeno valjan JSON
7
Podržani tipovi
Svi
xAI modeli
2
Načina poziva

Bez naspram sa strukturiranim izlazima

Evo što dobivaš bez ove značajke, a što s njom:

Bez strukturiranih izlaza:

  • Model može vratiti slobodan tekst, djelomični JSON ili neočekivani format
  • Moraš ručno parsirati i rukovati greškama
  • Nazivi polja mogu varirati od jednog zahtjeva do drugog
  • Tvoj pipeline puca čim model promijeni format

Sa strukturiranim izlazima:

  • JSON je uvijek sintaksno valjan
  • Struktura točno odgovara dostavljenoj shemi
  • Tipovi su poštovani (niz, broj, boolean itd.)
  • Tvoj kod može izravno konzumirati odgovor

Dva dostupna pristupa

Grok API nudi dvije metode za korištenje strukturiranih izlaza:

  • parse(): Automatska metoda koja izravno vraća tipizirani objekt. Idealna za većinu slučajeva.
  • response_format: Ručna metoda koja vraća JSON niz. Pruža veću kontrolu, ali parsiranje je na tebi.

Ove dvije metode detaljno ćeš otkriti u nadolazećim lekcijama.

Ključne točke

  • Strukturirani izlazi jamče JSON usklađen s tvojom shemom pri svakom pozivu
  • Ograničenje se primjenjuje tijekom generiranja, a ne nakon njega
  • Svi jezični modeli tvrtke xAI podržavaju ovu značajku
  • Dostupne su dvije metode: parse() (automatska) i response_format (ručna)
  • Ovo je temelj svakog pouzdanog produkcijskog pipelinea s Grok API-jem