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

Automatska metoda parse()

Lekcija 4 od 12 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Brzi put: parse()
  2. Potpuni primjer
  3. Što parse() vraća
  4. Ugniježđeni modeli
  5. Kada koristiti parse()
  6. Ključne točke

Ažurirano 3. studenog 2026. Na temelju dokumentacije Structured Outputs od xAI i openai SDK verzije 3.42.1: kada je OpenAI SDK usmjeren na xAI, metoda je client.chat.completions.parse, koja vraća kompletiranje gdje se tipizirani objekt čita iz choices[0].message.parsed; client.chat.parse ne postoji (xAI SDK nudi chat.parse(Schema) na razgovoru, što vraća par objekt-odgovor). Izvor: Structured Outputs.

Brzi put: parse()

Metoda parse() najjednostavniji je način korištenja strukturiranih izlaza s Grok API-jem. Prima Pydantic model kao ulaz i izravno vraća tipizirani objekt – bez potrebe za parsiranjem JSON-a ili ručnom validacijom.

1

Definiraj Pydantic model

Kreiraš Python klasu koja opisuje očekivanu strukturu.

2

Pozovi client.chat.completions.parse()

Prosljeđuješ Pydantic model kao response_format.

3

Primi torku (Odgovor, ParsiraniModel)

Tipizirani objekt spreman je za korištenje u tvom kodu.

Potpuni primjer

Evo kako izvući strukturiranu recenziju filma:

from openai import OpenAI
from pydantic import BaseModel

client = OpenAI(
    api_key="your-xai-key",
    base_url="https://api.x.ai/v1"
)

class MovieReview(BaseModel):
    title: str
    rating: float
    summary: str
    recommend: bool

completion = client.chat.completions.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Write a review of the movie Inception"
    }],
    response_format=MovieReview
)
parsed = completion.choices[0].message.parsed

# parsed je tipizirani MovieReview objekt
print(parsed.title)      # "Inception"
print(parsed.rating)     # 9.2
print(parsed.recommend)  # True
print(type(parsed))      # <class 'MovieReview'>

Što parse() vraća

Metoda parse() vraća torku s dva elementa:

  1. response: Puni objekt API odgovora (s metapodacima, utrošenim tokenima itd.)
  2. parsed: Tvoj Pydantic model instanciran s izvučenim podacima

Oba možeš koristiti po potrebi:

completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed

# Pristup metapodacima
print(completion.usage.total_tokens)
print(completion.model)

# Pristup strukturiranim podacima
print(parsed.title)
print(parsed.rating)

Ugniježđeni modeli

parse() bez napora obrađuje složene strukture. Možeš ugnijezditi Pydantic modele:

class Actor(BaseModel):
    name: str
    role: str

class Review(BaseModel):
    title: str
    director: str
    year: int
    rating: float
    main_actors: list[Actor]
    genres: list[str]
    strengths: list[str]
    weaknesses: list[str]

completion = client.chat.completions.parse(
    model="grok-4.20-0309-reasoning",
    messages=[{
        "role": "user",
        "content": "Complete analysis of the movie Interstellar"
    }],
    response_format=Review
)
parsed = completion.choices[0].message.parsed

for actor in parsed.main_actors:
    print(f"{actor.name} plays {actor.role}")

Kada koristiti parse()

parse() je najkraći put između odgovora modela i upotrebljivog Python objekta: ako radiš s Pydanticom, ovo je zadani izbor. Metoda obuhvaća sve – slanje sheme, validaciju odgovora, instanciranje objekta – i predaje ti izravno tipiziranu instancu, bez json.loads ili ručnih provjera. To je najkoncizniji mogući kod, a za veliku većinu slučajeva ta jednostavnost ne nosi nikakvu cijenu: odričeš se finog upravljanja parsiranjem samo ako ti je to stvarno trebalo, što je rijetko. Sljedeća lekcija pokriva upravo one slučajeve gdje je ručna kontrola opravdana.

Ključne točke

  • parse() vraća torku (Response, ParsedModel) – automatsko parsiranje
  • Vraćeni objekt je tipizirana i validirana Pydantic instanca
  • Ugniježđeni modeli i liste objekata rade nativno
  • Ovo je preporučena metoda za većinu slučajeva upotrebe u Pythonu
  • Nema potrebe za json.loads() ili ručnom validacijom