Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Το Python SDK της xAI

Μάθημα 5 / 14 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το επίσημο Python SDK της xAI
  2. Εγκατάσταση
  3. Αρχικοποίηση του πελάτη (Client)
  4. Αποστολή αιτήματος
  5. Πλεονεκτήματα του εγγενούς SDK
  6. Πότε να επιλέξετε αυτό το SDK
  7. Βασικά σημεία

Ενημερώθηκε στις 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).

pip
Τυπική εγκατάσταση
Client
Κύρια κλάση
Auto
Αυτόματος εντοπισμός κλειδιού API
Native
Πλήρης υποστήριξη xAI

Εγκατάσταση

Εγκαταστήστε το 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.7
  • messages: τα αρχικά μηνύματα της συνομιλίας, δομημένα με τα system(), user() και assistant() από το xai_sdk.chat (τα απλά λεξικά προκαλούν αποτυχία της κλήσης)
  • temperature: από 0 έως 2, με ανώτατο όριο το 1 για υψηλότερες τιμές· η xAI συνιστά το 0,7, με top_p στο 0,95
  • max_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