Το OpenAI SDK για το Grok
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026, με βάση τη σελίδα Models της xAI: το grok-4.7 (Σεπτέμβριος 2026) διαδέχθηκε το grok-4.5 ως το προτεινόμενο μοντέλο· το παράδειγμα, γραμμένο με το grok-4.5, λειτουργεί επίσης με το grok-4.7. Πηγές: Models · Release notes.
Διευκρινίστηκε στις 3 Νοεμβρίου 2026, με βάση την αναφορά Chat Completions της xAI: η κλήση δεν είναι αυστηρά ίδια με αυτή της OpenAI· οι παράμετροι
logprobsκαιtop_logprobs(που αγνοούνται από τοgrok-4.20και μετά) και τοlogit_bias(μη υποστηριζόμενο) προστίθενται στις διαφορές που παρατίθενται παρακάτω. Πηγή: xAI, Chat Completions.
Επαναχρησιμοποιήστε τις γνώσεις σας για την OpenAI
Αν εργάζεστε ήδη με το OpenAI SDK σε Python, μπορείτε να το χρησιμοποιήσετε ως έχει για να καλέσετε το Grok API. Απλώς ανακατευθύνετε τα αιτήματα στους διακομιστές της xAI αλλάζοντας το βασικό URL. Αυτή είναι η ταχύτερη προσέγγιση αν διαθέτετε ήδη κώδικα.
Εγκατάσταση
Αν το OpenAI SDK δεν είναι ακόμη εγκατεστημένο στο έργο σας:
pip install openai
Διαμόρφωση του client για την xAI
Η μόνη διαφορά από την τυπική χρήση της OpenAI είναι η παράμετρος base_url:
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Αυτό είναι όλο. Από εδώ και πέρα, κάθε μέθοδος του OpenAI SDK λειτουργεί με τα μοντέλα Grok.
Αποστολή μηνύματος
Η κλήση έχει την ίδια δομή με αυτήν για το GPT, εκτός από τις μη υποστηριζόμενες παραμέτρους (δείτε παρακάτω):
response = client.chat.completions.create(
model="grok-4.5",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What's the difference between REST and GraphQL?"}
],
temperature=0.7,
max_completion_tokens=500
)
print(response.choices[0].message.content)
Διαθέσιμα μοντέλα
Απλώς αντικαταστήστε το όνομα του μοντέλου της OpenAI με ένα μοντέλο Grok:
grok-4.7: το μοντέλο που προτείνει η xAI, ευέλικτο, με δυνατότητα εισαγωγής εικόνων (ταgrok-4.6καιgrok-4.5παραμένουν διαθέσιμα)grok-4.20-0309-reasoning: προηγμένη συλλογιστικήgrok-4.3: γρήγορες, οικονομικές απαντήσεις (πλαίσιο 1M)
Μεταφορά ενός υπάρχοντος έργου OpenAI
Για να προσαρμόσετε ένα υπάρχον έργο, έχετε δύο επιλογές.
Επιλογή 1: Μεταβλητές περιβάλλοντος
Αλλάξτε τις μεταβλητές σας χωρίς να πειράξετε τον κώδικα:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
Το OpenAI SDK διαβάζει αυτές τις μεταβλητές αυτόματα. Ο υπάρχων κώδικάς σας θα λειτουργήσει αν αλλάξετε επίσης το όνομα του μοντέλου και αφαιρέσετε τις παραμέτρους που δεν υποστηρίζει η xAI.
Επιλογή 2: Ρητή διαμόρφωση
Γράψτε μια συνάρτηση αρχικοποίησης που εναλλάσσεται μεταξύ παρόχων:
import os
from openai import OpenAI
def create_client(provider="xai"):
if provider == "xai":
return OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
return OpenAI() # OpenAI by default
client = create_client("xai")
Αυτή η προσέγγιση σάς επιτρέπει να εναλλάσσεστε εύκολα μεταξύ παρόχων κατά τη διάρκεια της μεταφοράς.
Διαφορές που πρέπει να γνωρίζετε
Παρόλο που το API είναι συμβατό, ορισμένες συμπεριφορές διαφέρουν:
- Οι παράμετροι
frequency_penaltyκαιpresence_penaltyδεν υποστηρίζονται στα μοντέλα συλλογιστικής - Η παράμετρος
stopδεν είναι διαθέσιμη στα μοντέλα συλλογιστικής - Τα
logprobsκαιtop_logprobsαγνοούνται σιωπηρά από τα μοντέλαgrok-4.20και νεότερα, ενώ τοlogit_biasδεν υποστηρίζεται - Τα ονόματα των μοντέλων είναι προφανώς διαφορετικά
- Ορισμένες λειτουργίες της xAI (αναζήτηση X, αναζήτηση στον ιστό) δεν είναι διαθέσιμες μέσω της τυπικής μορφής OpenAI
Πότε να επιλέξετε αυτή την προσέγγιση
Η λειτουργία συμβατότητας έχει νόημα όταν ο υπάρχων κώδικάς σας έχει μεγαλύτερη σημασία από τις αποκλειστικές λειτουργίες. Η πιο συνηθισμένη περίπτωση είναι η μετανάστευση: ο κώδικας που έχει ήδη γραφτεί για την OpenAI μεταβαίνει στο Grok αλλάζοντας το βασικό URL και το κλειδί: δύο γραμμές, χωρίς ξαναγράψιμο. Η αντιστρεψιμότητα έχει επίσης σημασία: όσο παραμένετε στη μορφή OpenAI, η αλλαγή παρόχου παραμένει θέμα διαμόρφωσης, κάτι που είναι πολύτιμο για τη σύγκριση μοντέλων ή τη διαπραγμάτευση. Στη συνέχεια, υπάρχει το οικοσύστημα: εργαλεία τρίτων κατασκευασμένα γύρω από το OpenAI SDK, όπως τα LangChain και LlamaIndex, λειτουργούν άμεσα, και μια ομάδα που γνωρίζει ήδη το SDK δεν έχει κάτι νέο να μάθει. Το τίμημα είναι αυτό που είδατε παραπάνω: οι λειτουργίες ειδικές για την xAI περνούν σε δεύτερη μοίρα.
Βασικά σημεία
- Προσθέστε
base_url="https://api.x.ai/v1"στον κατασκευαστήOpenAI() - Αντικαταστήστε το κλειδί API και το όνομα του μοντέλου
- Οι μεταβλητές
OPENAI_BASE_URLκαιOPENAI_API_KEYεπιτρέπουν μια μεταφορά χωρίς τροποποίηση του κώδικα - Ορισμένες παράμετροι (ποινές, stop) δεν υποστηρίζονται στα μοντέλα συλλογιστικής