Automatska metoda parse()
Na ovoj stranici
Ažurirano 3. studenog 2026. Na temelju dokumentacije Structured Outputs od xAI i
openaiSDK verzije 3.42.1: kada je OpenAI SDK usmjeren na xAI, metoda jeclient.chat.completions.parse, koja vraća kompletiranje gdje se tipizirani objekt čita izchoices[0].message.parsed;client.chat.parsene postoji (xAI SDK nudichat.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.
Definiraj Pydantic model
Kreiraš Python klasu koja opisuje očekivanu strukturu.
Pozovi client.chat.completions.parse()
Prosljeđuješ Pydantic model kao response_format.
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:
response: Puni objekt API odgovora (s metapodacima, utrošenim tokenima itd.)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