OpenAI SDK με base_url της xAI
Σε αυτήν τη σελίδα
Ενημερώθηκε στις 3 Νοεμβρίου 2026. Σύμφωνα με την αναφορά Chat Completions της xAI, η συμβατότητα με το OpenAI SDK δεν είναι «100%»: ορισμένες παράμετροι δεν υποστηρίζονται από τα μοντέλα συλλογισμού (reasoning models), αγνοούνται από τα πρόσφατα μοντέλα ή δεν υποστηρίζονται από κανένα μοντέλο. Πηγή: xAI, Chat Completions.
Χρήση του OpenAI SDK για πρόσβαση στο Grok
Ένα από τα κύρια πλεονεκτήματα του endpoint Chat Completions της xAI είναι η συμβατότητά του με το OpenAI SDK. Μπορείτε να χρησιμοποιήσετε το πακέτο openai που ήδη γνωρίζετε, αλλάζοντας απλώς το base_url ώστε να δείχνει στους διακομιστές της xAI.
Αυτή η προσέγγιση είναι ιδανική αν μεταφέρετε μια υπάρχουσα εφαρμογή από το OpenAI στο Grok ή αν θέλετε να εναλλάσσεστε μεταξύ παρόχων με ελάχιστες αλλαγές.
Διαμόρφωση
Η εγκατάσταση είναι ίδια με κάθε έργο που χρησιμοποιεί το OpenAI SDK:
pip install openai
Η μόνη διαφορά βρίσκεται στη δημιουργία του client, όπου ορίζετε το URL βάσης και το κλειδί API της xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Οι δύο βασικές παράμετροι είναι:
api_key: Το κλειδί API της xAI (όχι κλειδί του OpenAI)base_url:https://api.x.ai/v1—αυτό ανακατευθύνει τα αιτήματα στην xAI αντί για το OpenAI
Κλήσεις ίδιες με το OpenAI
Μόλις διαμορφωθεί ο client, η χρήση είναι η ίδια με το τυπικό OpenAI SDK—εκτός από τις παραμέτρους που δεν υποστηρίζει η xAI, οι οποίες λεπτομερούνται παρακάτω:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a technical assistant."},
{"role": "user", "content": "What is the difference between TCP and UDP?"}
],
temperature=0.7,
max_tokens=1000
)
print(response.choices[0].message.content)
Η μόνη ορατή διαφορά είναι το όνομα του μοντέλου: grok-4.20-0309-reasoning αντί για gpt-5.6, για παράδειγμα.
Ροή δεδομένων (Streaming) με το OpenAI SDK
Το streaming λειτουργεί ακριβώς με τον ίδιο τρόπο:
stream = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "user", "content": "Explain the concept of microservices."}
],
stream=True
)
for chunk in stream:
content = chunk.choices[0].delta.content
if content:
print(content, end="", flush=True)
JavaScript / TypeScript
Το OpenAI SDK για Node.js λειτουργεί με τον ίδιο τρόπο:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: "https://api.x.ai/v1",
});
const response = await client.chat.completions.create({
model: "grok-4.20-0309-reasoning",
messages: [
{ role: "system", content: "You are a helpful assistant." },
{ role: "user", content: "Hello, how are you?" },
],
});
console.log(response.choices[0].message.content);
Σημειώστε ότι στην JavaScript η ιδιότητα είναι baseURL (με κεφαλαίο U), ενώ στην Python είναι base_url.
Εναλλαγή μεταξύ παρόχων
Το κύριο όφελος αυτής της προσέγγισης είναι η δυνατότητα αλλαγής παρόχου με μία μόνο μεταβλητή:
import os
from openai import OpenAI
provider = os.getenv("LLM_PROVIDER", "xai")
configs = {
"xai": {
"api_key": os.getenv("XAI_API_KEY"),
"base_url": "https://api.x.ai/v1",
"model": "grok-4.20-0309-reasoning"
},
"openai": {
"api_key": os.getenv("OPENAI_API_KEY"),
"base_url": "https://api.openai.com/v1",
"model": "gpt-5.6"
}
}
config = configs[provider]
client = OpenAI(api_key=config["api_key"], base_url=config["base_url"])
Αυτή η αρχιτεκτονική πολλαπλών παρόχων είναι συχνή σε εφαρμογές παραγωγής που επιθυμούν να διατηρήσουν ευελιξία.
Τι δεν μεταφέρεται μεταξύ παρόχων
Το «συμβατό» δεν σημαίνει «πανομοιότυπο». Η αναφορά του endpoint της xAI επισημαίνει αρκετές παραμέτρους που δεν υποστηρίζουν τα μοντέλα συλλογισμού—frequency_penalty, presence_penalty (όπως στο grok-3) και stop. Τα logprobs και top_logprobs αγνοούνται χωρίς σφάλμα από τα grok-4.20 και νεότερα μοντέλα, ενώ το logit_bias δεν υποστηρίζεται. Ο κώδικας που ορίζει αυτές τις παραμέτρους για το OpenAI θα πρέπει να τις αφαιρέσει για το Grok. Τα πεδία που αγνοούνται σιωπηλά είναι τα πιο δύσκολα, καθώς τίποτα δεν σηματοδοτεί ότι δεν έχουν κανένα αποτέλεσμα. Επίσης, τα φιλοξενούμενα εργαλεία διαφέρουν μεταξύ παρόχων: η αναζήτηση ιστού του OpenAI δεν είναι ίδια με της xAI. Τέλος, η xAI πλέον χαρακτηρίζει τα Chat Completions ως legacy endpoint και συνιστά το Responses API (μαθήματα 11 και 12).
Βασικά σημεία
- Το OpenAI SDK λειτουργεί με την xAI αλλάζοντας απλώς το
base_urlσεhttps://api.x.ai/v1 - Οι μέθοδοι και οι μορφές απόκρισης είναι ίδιες, αλλά ορισμένες παράμετροι δεν υποστηρίζονται (
frequency_penalty,presence_penalty,stopστα μοντέλα συλλογισμού,logit_bias) ή αγνοούνται (logprobsαπό τοgrok-4.20και μετά) - Προσαρμόστε το κλειδί API, το όνομα του μοντέλου και αφαιρέστε τις μη υποστηριζόμενες παραμέτρους
- Αυτή η προσέγγιση απλοποιεί τη μετάβαση από το OpenAI και επιτρέπει την εναλλαγή μεταξύ παρόχων
- Το streaming και οι τύποι του OpenAI SDK λειτουργούν· τα φιλοξενούμενα εργαλεία είναι συγκεκριμένα για κάθε πάροχο