Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

OpenAI SDK so základňou xAI base_url

Lekcia 5 z 12 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Používanie OpenAI SDK na prístup ku Grok
  2. Konfigurácia
  3. Volania totožné s OpenAI
  4. Streamovanie pomocou OpenAI SDK
  5. JavaScript / TypeScript
  6. Prepínanie medzi poskytovateľmi
  7. Čo sa medzi poskytovateľmi neprenáša
  8. Kľúčové poznatky

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_url na https://api.x.ai/v1
  • Metódy a formáty odpovedí sú rovnaké, ale niektoré parametre nie sú podporované (frequency_penalty, presence_penalty, stop pri modeloch na logické usudzovanie, logit_bias) alebo sú ignorované (logprobs od verzie grok-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