Automatická metoda parse()
Na této stránce
Aktualizováno 3. listopadu 2026. Na základě dokumentace Structured Outputs od xAI a SDK
openaiverze 3.42.1: Při použití OpenAI SDK směřujícího na xAI je metodouclient.chat.completions.parse, která vrací dokončení, kde je typovaný objekt čten zchoices[0].message.parsed;client.chat.parseneexistuje (SDK xAI sice nabízíchat.parse(Schema)na konverzaci, které vrací pár odpověď-objekt). Zdroj: Structured Outputs.
Rychlá cesta: parse()
Metoda parse() je nejjednodušší způsob, jak využít strukturované výstupy s API Grok. Jako vstup přijímá model Pydantic a přímo vrací typovaný objekt – žádné parsování JSONu, žádná ruční validace.
Definuj model Pydantic
Vytvoříš třídu v Pythonu, která popisuje očekávanou strukturu.
Zavolej client.chat.completions.parse()
Model Pydantic předáš jako parametr response_format.
Obdrž tuple (Odpověď, ParsedModel)
Typovaný objekt je připraven k použití ve tvém kódu.
Kompletní příklad
Zde je ukázka, jak extrahovat strukturovanou recenzi 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'>
Co vrací parse()
Metoda parse() vrací tuple o dvou prvcích:
response: Plný objekt odpovědi API (s metadaty, počtem použitých tokenů atd.)parsed: Tvůj model Pydantic instantciovaný s extrahovanými daty
Oba prvky můžeš podle potřeby využít:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Přístup k metadatům
print(completion.usage.total_tokens)
print(completion.model)
# Přístup ke strukturovaným datům
print(parsed.title)
print(parsed.rating)
Vnořené modely
parse() bez problémů zvládá složité struktury. Modely Pydantic můžeš vnořovat:
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}")
Kdy použít parse()
parse() je nejkratší cestou mezi odpovědí modelu a použitelným objektem v Pythonu: pokud pracuješ s Pydantic, je to výchozí volba. Tato metoda zapouzdřuje vše – odeslání schématu, validaci odpovědi, instantciaci objektu – a předá ti přímo typovanou instanci, bez nutnosti používat json.loads nebo provádět ruční kontroly. Je to nejúspornější možný kód a pro drtivou většinu případů přichází tato jednoduchost bez jakékoli újmy: vzdáváš se jemné kontroly nad parsováním pouze tehdy, pokud bys ji skutečně potřeboval, což je vzácné. Následující lekce se věnuje právě těm případům, kdy je ruční kontrola oprávněná.
Klíčové poznatky
parse()vrací tuple(Response, ParsedModel)– automatické parsování- Vrácený objekt je typovaná a validovaná instance Pydantic
- Vnořené modely a seznamy objektů fungují nativně
- Toto je doporučená metoda pro většinu případů použití v Pythonu
- Není potřeba používat
json.loads()ani provádět ruční validaci