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

OpenAI SDK με base_url της xAI

Μάθημα 5 / 12 Ενημερώθηκε 3 Νοεμβρίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Χρήση του OpenAI SDK για πρόσβαση στο Grok
  2. Διαμόρφωση
  3. Κλήσεις ίδιες με το OpenAI
  4. Ροή δεδομένων (Streaming) με το OpenAI SDK
  5. JavaScript / TypeScript
  6. Εναλλαγή μεταξύ παρόχων
  7. Τι δεν μεταφέρεται μεταξύ παρόχων
  8. Βασικά σημεία

Ενημερώθηκε στις 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 λειτουργούν· τα φιλοξενούμενα εργαλεία είναι συγκεκριμένα για κάθε πάροχο