Το Python SDK της xAI
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026, με βάση τις βέλτιστες πρακτικές και την αναφορά API της xAI: η θερμοκρασία (temperature) περιορίζεται στο 1 και συνιστάται η τιμή 0,7. Πηγή: Βέλτιστες πρακτικές. Το παράδειγμα κλήσης ακολουθεί το README του SDK (
chat.append(user(...)),chat.sample(),response.content) και εκτελέστηκε για επαλήθευση.
Το επίσημο Python SDK της xAI
Το εγγενές Python SDK της xAI αποτελεί τον πιο άμεσο τρόπο εργασίας με το Grok API. Εκθέτει τις ειδικές λειτουργίες της πλατφόρμας και λαμβάνει ενημερώσεις πρώτο όταν προστίθενται νέα μοντέλα ή τελικά σημεία (endpoints).
Εγκατάσταση
Εγκαταστήστε το SDK με το pip στο περιβάλλον Python σας:
pip install xai-sdk
Συνιστούμε τη χρήση εικονικού περιβάλλοντος (virtual environment) για την απομόνωση των εξαρτήσεων κάθε έργου:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Αρχικοποίηση του πελάτη (Client)
Η κλάση Client αποτελεί το σημείο εισόδου του SDK. Διαχειρίζεται τον έλεγχο ταυτότητας, τις συνδέσεις HTTP και τη σειριοποίηση των αιτημάτων:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Εάν η μεταβλητή περιβάλλοντος XAI_API_KEY έχει οριστεί, μπορείτε επίσης να δημιουργήσετε τον πελάτη χωρίς ρητό όρισμα:
client = Client()
Το SDK εντοπίζει αυτόματα τη μεταβλητή και τη χρησιμοποιεί για την πιστοποίηση.
Αποστολή αιτήματος
Μόλις αρχικοποιηθεί ο πελάτης, το SDK λειτουργεί με βάση τις συνομιλίες: το client.chat.create() δημιουργεί τη συνομιλία (χωρίς να στείλει κάτι), το append προσθέτει ένα μήνυμα δομημένο με user() ή system(), και το sample() ζητά την απάντηση από το μοντέλο:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.7")
chat.append(user("Explain what a REST API is in 3 sentences."))
response = chat.sample()
print(response.content)
Κοινές παράμετροι
model: το αναγνωριστικό (ID) του μοντέλου προς χρήση (απαιτείται)· η xAI συνιστά τοgrok-4.7messages: τα αρχικά μηνύματα της συνομιλίας, δομημένα με ταsystem(),user()καιassistant()από τοxai_sdk.chat(τα απλά λεξικά προκαλούν αποτυχία της κλήσης)temperature: από 0 έως 2, με ανώτατο όριο το 1 για υψηλότερες τιμές· η xAI συνιστά το 0,7, μεtop_pστο 0,95max_tokens: ο μέγιστος αριθμός tokens που θα παραχθούνreasoning_effort: το βάθος συλλογισμού (none,low,medium,high), το οποίο η xAI συνιστά να ορίζεται σε κάθε αίτημα
Η ροή δεδομένων (streaming) δεν γίνεται μέσω παραμέτρου: η εντολή for response, chunk in chat.stream(): επιστρέφει τα τμήματα καθώς φτάνουν στο chunk.content. Το Μάθημα 10 παρουσιάζει το streaming με το REST API, μέσω SSE.
Πλεονεκτήματα του εγγενούς SDK
Σε σύγκριση με το OpenAI SDK που δείχνει στο xAI API (επόμενο μάθημα), το εγγενές SDK παρέχει άμεση πρόσβαση σε λειτουργίες ειδικές για την xAI: αναζήτηση στο X και στον ιστό, εργαλεία πλευράς διακομιστή, παραγωγή βίντεο, συλλογές εγγράφων. Οι πλήρεις τύποι Python ενισχύουν την αυτόματη συμπλήρωση του επεξεργαστή σας και η xAI το συντηρεί συγχρονισμένα με τον ρυθμό του API. Διαθέτει επίσης τη δική του δομή, την οποία πρέπει να αποδεχτείτε: εκτελείται μέσω gRPC, τα μηνύματά του δομούνται με user() και system(), και τα σφάλματά του είναι τύπου grpc.RpcError.
Πότε να επιλέξετε αυτό το SDK
Η επιλογή προκύπτει φυσικά από την κατάστασή σας. Για ένα νέο έργο χτισμένο ειδικά πάνω στο Grok API, το εγγενές SDK είναι το προφανές σημείο εκκίνησης: αποκτάτε όλα τα παραπάνω χωρίς περιορισμούς συμβατότητας. Καθίσταται απαραίτητο μόλις σχεδιάζετε να χρησιμοποιήσετε λειτουργίες ειδικές της xAI, όπως η αναζήτηση στο X ή η ενσωματωμένη αναζήτηση ιστού, οι οποίες λειτουργούν πλήρως μόνο με αυτόν τον τρόπο. Αν, από την άλλη πλευρά, διαθέτετε υπάρχοντα κώδικα χτισμένο στο OpenAI SDK, μην ξαναγράψετε τίποτα προς το παρόν: το επόμενο μάθημα δείχνει πώς να το προσαρμόσετε αλλάζοντας δύο γραμμές.
Βασικά σημεία
- Εγκαταστήστε με
pip install xai-sdkσε εικονικό περιβάλλον - Η κλάση
Clientείναι το σημείο εισόδου, με αυτόματο εντοπισμό τουXAI_API_KEY - Το
client.chat.create()δημιουργεί μια συνομιλία· τοchat.append(user(...))προσθέτει ένα μήνυμα και τοchat.sample()επιστρέφει την απάντηση, η οποία διαβάζεται από τοresponse.content - Προτιμήστε αυτό το SDK για νέα έργα που στοχεύουν αποκλειστικά στο Grok API