Samodejna metoda parse()
Na tej strani
Posodobljeno 3. novembra 2026. Na podlagi dokumentacije Structured Outputs podjetja xAI in SDK
openairazličice 3.42.1: ko je SDK OpenAI usmerjen na xAI, je metodaclient.chat.completions.parse, ki vrne zaključek, kjer se tipizirani objekt prebere izchoices[0].message.parsed;client.chat.parsene obstaja (SDK xAI sicer ponujachat.parse(Schema)na pogovoru, ki vrne par odgovor-objekt). Vir: Structured Outputs.
Hitra pot: parse()
Metoda parse() je najpreprostejši način za uporabo strukturiranih izhodov z API-jem Grok. Kot vhod sprejme model Pydantic in neposredno vrne tipiziran objekt – brez potrebe po razčlenjevanju JSON-a ali ročnem preverjanju veljavnosti.
Definiraj model Pydantic
Ustvariš razred Python, ki opisuje pričakovano strukturo.
Pokliči client.chat.completions.parse()
Model Pydantic posreduješ kot response_format.
Prejmi nabor (Response, ParsedModel)
Tipizirani objekt je pripravljen za uporabo v tvoji kodi.
Celoten primer
Tako izvlečeš strukturirano filmsko recenzijo:
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 tipiziran objekt MovieReview
print(parsed.title) # "Inception"
print(parsed.rating) # 9.2
print(parsed.recommend) # True
print(type(parsed)) # <class 'MovieReview'>
Kaj vrača parse()?
Metoda parse() vrača nabor z dvema elementoma:
response: Celoten objekt odgovora API-ja (z metapodatki, porabljenimi žetoni itd.)parsed: Tvoj model Pydantic, inicializiran z izvlečenimi podatki
Dostopaš lahko do obeh, kadar koli potrebuješ:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Dostop do metapodatkov
print(completion.usage.total_tokens)
print(completion.model)
# Dostop do strukturiranih podatkov
print(parsed.title)
print(parsed.rating)
Gnezdeni modeli
parse() brez težav obvlada kompleksne strukture. Modelle Pydantic lahko gnezdiš:
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}")
Kdaj uporabiti parse()?
parse() je najkrajša pot med odgovorom modela in uporabnim objektom Python: če delaš s Pydantic, je to privzeta izbira. Metoda zajema vse – pošiljanje sheme, preverjanje veljavnosti odgovora, inicializacijo objekta – in ti neposredno izroči tipiziran primerek, brez json.loads ali ročnih preverjanj. To je najbolj jedrnata možna koda in za veliko večino primerov ta preprostost nima nobene cene: odpoveš se le nadzoru nad razčlenjevanjem na nizki ravni, če bi ga dejansko potreboval, kar je redko. Naslednja lekcija pokriva prav tiste primere, kjer je ročni nadzor upravičen.
Ključne ugotovitve
parse()vrača nabor(Response, ParsedModel)– samodejno razčlenjevanje- Vrnjeni objekt je tipiziran in preverjen primerek Pydantic
- Gnezdeni modeli in seznami objektov delujejo naravno
- To je priporočena metoda za večino primerov uporabe v Pythonu
- Ni potrebe po
json.loads()ali ročnem preverjanju veljavnosti