OpenAI SDK z osnovnim URL-jem xAI
Na tej strani
Posodobljeno 3. novembra 2026. Glede na referenčno dokumentacijo xAI Chat Completions združljivost z OpenAI SDK ni „100-odstotna” – nekaterih parametrov modeli za sklepanje ne podpirajo, novejši modeli jih ignorirajo ali pa jih ne podpira noben model. Vir: xAI, Chat Completions.
Uporaba OpenAI SDK za dostop do Groka
Ena glavnih prednosti končne točke xAI Chat Completions je njena združljivost z OpenAI SDK. Uporabiš lahko paket openai, ki ga že poznaš, pri čemer spremeniš le base_url, da kaže na strežnike xAI.
Ta pristop je idealen, če seliš obstoječo aplikacijo z OpenAI na Grok ali če želiš med ponudniki prehajati z minimalnimi spremembami.
Konfiguracija
Namestitev je enaka kot pri vsakem projektu, ki uporablja OpenAI SDK:
pip install openai
Edina razlika je v ustvarjanju odjemalca, kjer določiš osnovni URL in ključ API xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Dva ključna parametra sta:
api_key: Tvoj ključ API xAI (ne ključ OpenAI)base_url:https://api.x.ai/v1– to preusmeri zahteve na xAI namesto na OpenAI
Klici, identični tistim za OpenAI
Ko je odjemalec konfiguriran, je uporaba enaka kot pri standardnem OpenAI SDK – razen pri parametrih, ki jih xAI ne podpira, kar je podrobneje opisano spodaj:
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)
Edina vidna razlika je ime modela: grok-4.20-0309-reasoning namesto na primer gpt-5.6.
Pretakanje z OpenAI SDK
Pretakanje deluje popolnoma enako:
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 za Node.js deluje na enak način:
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);
Upoštevaj, da je lastnost v JavaScriptu baseURL (velika črka U), medtem ko je v Pythonu base_url.
Preklapljanje med ponudniki
Glavna prednost tega pristopa je možnost spremembe ponudnika z eno samo spremenljivko:
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"])
Ta arhitektura z več ponudniki je pogosta v produkcijskih aplikacijah, ki želijo ohraniti prilagodljivost.
Kaj se ne prenese med ponudniki
Združljivost ne pomeni identičnosti. Referenčna dokumentacija končne točke xAI opozarja na več parametrov, ki jih modeli za sklepanje ne podpirajo – frequency_penalty, presence_penalty (kot pri grok-3) in stop. Parametra logprobs in top_logprobs modeli grok-4.20 in novejši ignorirajo brez napake, logit_bias pa ni podprt. Koda, ki te parametre nastavlja za OpenAI, jih bo treba za Grok odstraniti. Najbolj zahrbtna so polja, ki se tiho ignorirajo, saj nič ne signalizira, da nimajo učinka. Gostovana orodja se med ponudniki prav tako razlikujejo: spletno iskanje OpenAI ni enako iskanju xAI. Končno xAI Chat Completions zdaj uvršča med zastarele končne točke in priporoča API Responses (lekciji 11 in 12).
Ključne ugotovitve
- OpenAI SDK deluje z xAI tako, da preprosto spremeniš
base_urlvhttps://api.x.ai/v1 - Metode in formati odgovorov so enaki, vendar nekateri parametri niso podprti (
frequency_penalty,presence_penalty,stoppri modelih za sklepanje,logit_bias) ali pa se ignorirajo (logprobsodgrok-4.20naprej) - Prilagodi ključ API, ime modela in nepodprte parametre
- Ta pristop poenostavi selitev z OpenAI in omogoča preklapljanje med ponudniki
- Pretakanje in tipizacija OpenAI SDK delujeta; gostovana orodja so specifična za vsakega ponudnika