OpenAI SDK so základňou xAI base_url
Na tejto strane
Aktualizované 3. novembra 2026. Podľa referencie xAI Chat Completions nie je kompatibilita so SDK OpenAI „100 %“ – niekoľko parametrov nie je podporovaných modelmi na logické usudzovanie, novšie modely ich ignorujú alebo ich nepodporuje žiadny model. Zdroj: xAI, Chat Completions.
Používanie OpenAI SDK na prístup ku Grok
Jednou z hlavných výhod koncového bodu xAI Chat Completions je jeho kompatibilita so SDK OpenAI. Môžeš použiť balík openai, ktorý už poznáš, a len zmeniť base_url tak, aby smeroval na servery xAI.
Tento prístup je ideálny, ak migruješ existujúcu aplikáciu z OpenAI na Grok, alebo ak chceš prepínať medzi poskytovateľmi s minimálnymi zmenami.
Konfigurácia
Inštalácia je rovnaká ako pri akomkoľvek projekte využívajúcom SDK OpenAI:
pip install openai
Jediný rozdiel je vo vytvorení klienta, kde zadáš základnú URL a kľúč API xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Dva kľúčové parametre sú:
api_key: Tvoj kľúč API xAI (nie kľúč OpenAI)base_url:https://api.x.ai/v1– toto presmeruje požiadavky na xAI namiesto OpenAI
Volania totožné s OpenAI
Po nakonfigurovaní klienta je používanie rovnaké ako pri štandardnom SDK OpenAI – okrem parametrov, ktoré xAI nepodporuje a ktoré sú podrobne popísané nižšie:
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)
Jediný viditeľný rozdiel je názov modelu: grok-4.20-0309-reasoning namiesto napríklad gpt-5.6.
Streamovanie pomocou OpenAI SDK
Streamovanie funguje presne rovnakým spôsobom:
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
SDK OpenAI pre Node.js funguje rovnako:
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);
Všimni si, že v JavaScripte sa vlastnosť nazýva baseURL (veľké U), zatiaľ čo v Pythone je to base_url.
Prepínanie medzi poskytovateľmi
Hlavnou výhodou tohto prístupu je možnosť zmeniť poskytovateľa pomocou jednej premennej:
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"])
Táto architektúra s viacerými poskytovateľmi je bežná v produkčných aplikáciách, ktoré chcú zachovať flexibilitu.
Čo sa medzi poskytovateľmi neprenáša
Kompatibilné neznamená totožné. Referencia koncového bodu xAI upozorňuje na niekoľko parametrov, ktoré modely na logické usudzovanie nepodporujú – frequency_penalty, presence_penalty (ako pri grok-3) a stop. Parametre logprobs a top_logprobs sú modelmi grok-4.20 a novšími ignorované bez chyby a logit_bias nie je podporovaný. Kód, ktorý tieto parametre nastavuje pre OpenAI, bude potrebné pre Grok upraviť a odstrániť ich. Najzáludnejšie sú ticho ignorované polia, pretože nič nenaznačuje, že nemajú žiadny účinok. Hostované nástroje sa tiež líšia medzi poskytovateľmi: webové vyhľadávanie od OpenAI nie je to isté ako od xAI. Nakoniec, xAI teraz klasifikuje Chat Completions ako zastaraný koncový bod a odporúca API Responses (lekcie 11 a 12).
Kľúčové poznatky
- SDK OpenAI funguje s xAI jednoduchou zmenou
base_urlnahttps://api.x.ai/v1 - Metódy a formáty odpovedí sú rovnaké, ale niektoré parametre nie sú podporované (
frequency_penalty,presence_penalty,stoppri modeloch na logické usudzovanie,logit_bias) alebo sú ignorované (logprobsod verziegrok-4.20ďalej) - Prispôsob kľúč API, názov modelu a nepodporované parametre
- Tento prístup zjednodušuje migráciu z OpenAI a umožňuje prepínanie medzi poskytovateľmi
- Streamovanie a typovanie SDK OpenAI fungujú; hostované nástroje sú špecifické pre každého poskytovateľa