Αυτόματη μέθοδος parse()
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Με βάση την τεκμηρίωση Structured Outputs της xAI και το
openaiSDK 3.42.1: όταν το OpenAI SDK δείχνει στην xAI, η μέθοδος είναιclient.chat.completions.parse, η οποία επιστρέφει μια ολοκλήρωση όπου το typed object διαβάζεται από τοchoices[0].message.parsed· τοclient.chat.parseδεν υπάρχει (το xAI SDK προσφέρει ωστόσο τοchat.parse(Schema)σε μια συνομιλία, το οποίο επιστρέφει ένα ζεύγος response-object). Πηγή: Structured Outputs.
Η γρήγορη διαδρομή: parse()
Η μέθοδος parse() είναι ο απλούστερος τρόπος χρήσης δομημένων εξόδων με το Grok API. Δέχεται ως είσοδο ένα μοντέλο Pydantic και επιστρέφει απευθείας ένα typed object—χωρίς ανάλυση JSON, χωρίς χειροκίνητη επικύρωση.
Ορίστε το μοντέλο Pydantic
Δημιουργείτε μια κλάση Python που περιγράφει την αναμενόμενη δομή.
Καλέστε το client.chat.completions.parse()
Περνάτε το μοντέλο Pydantic ως response_format.
Λάβετε το tuple (Response, ParsedModel)
Το typed object είναι έτοιμο για χρήση στον κώδικά σας.
Πλήρες παράδειγμα
Ορίστε πώς εξάγετε μια δομημένη κριτική ταινίας:
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 is a typed MovieReview object
print(parsed.title) # "Inception"
print(parsed.rating) # 9.2
print(parsed.recommend) # True
print(type(parsed)) # <class 'MovieReview'>
Τι επιστρέφει το parse()
Η μέθοδος parse() επιστρέφει ένα tuple δύο στοιχείων:
response: Το πλήρες αντικείμενο απόκρισης API (με μεταδεδομένα, tokens που χρησιμοποιήθηκαν κ.λπ.)parsed: Το μοντέλο Pydantic σας, στιγμιότυποποιημένο με τα εξαγόμενα δεδομένα
Μπορείτε να προσπελάσετε και τα δύο κατά περίπτωση:
completion = client.chat.completions.parse(...)
parsed = completion.choices[0].message.parsed
# Access metadata
print(completion.usage.total_tokens)
print(completion.model)
# Access structured data
print(parsed.title)
print(parsed.rating)
Ένθετα μοντέλα
Το parse() διαχειρίζεται πολύπλοκες δομές με ευκολία. Μπορείτε να ενθέσετε μοντέλα Pydantic:
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}")
Πότε να χρησιμοποιήσετε το parse()
Το parse() αποτελεί τη συντομότερη διαδρομή μεταξύ μιας απόκρισης μοντέλου και ενός usable Python object: αν εργάζεστε με Pydantic, αυτή είναι η προεπιλεγμένη επιλογή. Η μέθοδος περικλείει τα πάντα—αποστολή του σχήματος, επικύρωση της απόκρισης, στιγμιότυποποίηση του αντικειμένου—και σας παραδίδει απευθείας ένα typed instance, χωρίς json.loads ή χειροκίνητους ελέγχους. Πρόκειται για τον πιο συνοπτικό κώδικα δυνατόν και, για τη συντριπτική πλειοψηφία των περιπτώσεων, αυτή η απλότητα δεν έχει κόστος: χάνετε τον λεπτομερή έλεγχο ανάλυσης μόνο αν τον χρειάζεστε πραγματικά, κάτι που σπανίζει. Το επόμενο μάθημα καλύπτει ακριβώς εκείνες τις περιπτώσεις όπου ο χειροκίνητος έλεγχος είναι δικαιολογημένος.
Βασικά σημεία
- Το
parse()επιστρέφει ένα tuple(Response, ParsedModel)—αυτόματη ανάλυση - Το επιστρεφόμενο αντικείμενο είναι ένα typed και επικυρωμένο instance Pydantic
- Τα ένθετα μοντέλα και οι λίστες αντικειμένων λειτουργούν εγγενώς
- Αυτή είναι η συνιστώμενη μέθοδος για τις περισσότερες περιπτώσεις χρήσης σε Python
- Δεν χρειάζεται
json.loads()ούτε χειροκίνητη επικύρωση