Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

OpenAI SDK z osnovnim URL-jem xAI

Lekcija 5 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Uporaba OpenAI SDK za dostop do Groka
  2. Konfiguracija
  3. Klici, identični tistim za OpenAI
  4. Pretakanje z OpenAI SDK
  5. JavaScript / TypeScript
  6. Preklapljanje med ponudniki
  7. Kaj se ne prenese med ponudniki
  8. Ključne ugotovitve

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_url v https://api.x.ai/v1
  • Metode in formati odgovorov so enaki, vendar nekateri parametri niso podprti (frequency_penalty, presence_penalty, stop pri modelih za sklepanje, logit_bias) ali pa se ignorirajo (logprobs od grok-4.20 naprej)
  • 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