Automatická metóda parse()
Na tejto strane
Aktualizované 3. novembra 2026. Na základe dokumentácie Structured Outputs od xAI a SDK
openaiverzie 3.42.1: pri použití OpenAI SDK smerujúceho na xAI je metódaclient.chat.completions.parse, ktorá vracia doplnenie, kde sa typovaný objekt číta zchoices[0].message.parsed;client.chat.parseneexistuje (SDK xAI síce ponúkachat.parse(Schema)na konverzácii, ktoré vracia pár objektov odpoveď-objekt). Zdroj: Structured Outputs.
Rýchla cesta: parse()
Metóda parse() je najjednoduchší spôsob, ako využiť štruktúrované výstupy s API Grok. Ako vstup prijíma model Pydantic a priamo vracia typovaný objekt – žiadne parsovanie JSON, žiadna manuálna validácia.
Definuj model Pydantic
Vytvoríš triedu v Pythone, ktorá opisuje očakávanú štruktúru.
Volaj client.chat.completions.parse()
Model Pydantic odovzdáš ako parameter response_format.
Prijmi n-ticu (Odpoveď, ParsedModel)
Typovaný objekt je pripravený na použitie v tvojom kóde.
Kompletný príklad
Tu je ukážka, ako extrahovať štruktúrovanú recenziu filmu:
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 typovaný objekt MovieReview
print(parsed.title) # "Inception"
print(parsed.rating) # 9.2
print(parsed.recommend) # True
print(type(parsed)) # <class 'MovieReview'>
Čo vracia parse()
Metóda parse() vracia n-ticu s dvoma prvkami:
response: Úplný objekt odpovede API (s metadátami, použitými tokenmi atď.)parsed: Tvoj model Pydantic inštalovaný s extrahovanými dátami
Oba môžeš podľa potreby využiť:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Prístup k metadátam
print(completion.usage.total_tokens)
print(completion.model)
# Prístup k štruktúrovaným dátam
print(parsed.title)
print(parsed.rating)
Vnorené modely
parse() bez problémov zvláda komplexné štruktúry. Modely Pydantic môžeš vnárať:
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}")
Kedy použiť parse()
parse() je najkratšia cesta medzi odpoveďou modelu a použiteľným objektom v Pythone: ak pracuješ s Pydantic, toto je voľba predvolená. Metóda zapuzdruje všetko – odoslanie schémy, validáciu odpovede, inštaláciu objektu – a odovzdá ti priamo typovanú inštanciu, bez potreby json.loads alebo manuálnych kontrol. Je to najúspornejší možný kód a pre veľkú väčšinu prípadov táto jednoduchosť nič nestojí: vzdávaš sa jemnej kontroly nad parsovaním len vtedy, ak ju skutočne potrebuješ, čo je zriedkavé. Nasledujúca lekcia pokrýva presne tie prípady, kde je manuálna kontrola opodstatnená.
Kľúčové poznatky
parse()vracia n-ticu(Response, ParsedModel)– automatické parsovanie- Vrátaný objekt je typovaná a validovaná inštancia Pydantic
- Vnorené modely a zoznamy objektov fungujú natívne
- Toto je odporúčaná metóda pre väčšinu prípadov použitia v Pythone
- Nie je potrebné volať
json.loads()ani vykonávať manuálnu validáciu