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

OpenAI SDK pre Grok

Lekcia 6 z 14 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Využi to, čo už vieš o OpenAI
  2. Inštalácia
  3. Konfigurácia klienta pre xAI
  4. Odoslanie správy
  5. Migrácia existujúceho projektu OpenAI
  6. Rozdiely, ktoré treba poznať
  7. Kedy zvoliť tento prístup
  8. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe stránky Models od xAI: model grok-4.7 (september 2026) nahradil grok-4.5 ako odporúčaný model; príklad napísaný pre grok-4.5 funguje aj s grok-4.7. Zdroje: Models · Release notes.

Spresnené 3. novembra 2026 na základe referencie Chat Completions od xAI: volanie nie je úplne totožné s OpenAI; parametre logprobs a top_logprobs (ignorované od verzie grok-4.20) a logit_bias (nepodporovaný) rozširujú nižšie uvedené rozdiely. Zdroj: xAI, Chat Completions.

Využi to, čo už vieš o OpenAI

Ak už pracuješ s OpenAI SDK v Pythone, môžeš ho použiť tak, ako je, na volanie Grok API. Stačí presmerovať požiadavky na servery xAI zmenou základnej URL. Je to najrýchlejší prístup, ak už máš hotový kód.

Inštalácia

Ak ešte nemáš v projekte nainštalované OpenAI SDK:

pip install openai

Konfigurácia klienta pre xAI

Jediný rozdiel oproti bežnému používaniu OpenAI je parameter base_url:

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

To je všetko. Od tohto momentu fungujú všetky metódy OpenAI SDK s modelmi Grok.

Odoslanie správy

Volanie má rovnakú štruktúru ako pri GPT, okrem nepodporovaných parametrov (pozri nižšie):

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "system", "content": "You are a technical assistant."},
        {"role": "user", "content": "What's the difference between REST and GraphQL?"}
    ],
    temperature=0.7,
    max_completion_tokens=500
)

print(response.choices[0].message.content)

Dostupné modely

Stačí nahradiť názov modelu OpenAI názvom modelu Grok:

  • grok-4.7: model odporúčaný xAI, všestranný, podporuje vstup obrázkov (modely grok-4.6 a grok-4.5 zostávajú dostupné)
  • grok-4.20-0309-reasoning: pokročilé logické usudzovanie
  • grok-4.3: rýchle a lacné odpovede (kontext 1M)

Migrácia existujúceho projektu OpenAI

Na úpravu existujúceho projektu máš dve možnosti.

Možnosť 1: Premenné prostredia

Zmeň premenné bez zásahu do kódu:

export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"

OpenAI SDK si tieto premenné načíta automaticky. Tvoj existujúci kód bude fungovať, ak zároveň zmeníš názov modelu a odstrániš parametre, ktoré xAI nepodporuje.

Možnosť 2: Explicitná konfigurácia

Napíš inicializačnú funkciu, ktorá prepína medzi poskytovateľmi:

import os
from openai import OpenAI

def create_client(provider="xai"):
    if provider == "xai":
        return OpenAI(
            api_key=os.getenv("XAI_API_KEY"),
            base_url="https://api.x.ai/v1"
        )
    return OpenAI()  # Predvolené OpenAI

client = create_client("xai")

Tento prístup ti umožňuje počas migrácie ľahko prepínať medzi poskytovateľmi.

Rozdiely, ktoré treba poznať

Hoci je API kompatibilné, niektoré správanie sa líši:

  • Parametre frequency_penalty a presence_penalty nie sú podporované pri modeloch na logické usudzovanie
  • Parameter stop nie je dostupný pri modeloch na logické usudzovanie
  • logprobs a top_logprobs sú modelmi grok-4.20 a novšími ticho ignorované a logit_bias nie je podporovaný
  • Názvy modelov sú samozrejme odlišné
  • Niektoré funkcie xAI (vyhľadávanie na X, webové vyhľadávanie) nie sú dostupné cez štandardný formát OpenAI

Kedy zvoliť tento prístup

Režim kompatibility dáva najväčší zmysel vtedy, keď je pre teba dôležitejší existujúci kód než exkluzívne funkcie. Najčastejším prípadom je migrácia: kód už napísaný pre OpenAI prejde na Grok zmenou základnej URL a kľúča: dva riadky, žiadne prepisovanie. Dôležitá je aj reverzibilita: pokiaľ zostaneš pri formáte OpenAI, zmena poskytovateľa zostáva otázkou konfigurácie, čo je cenné pri porovnávaní modelov alebo vyjednávaní. Potom je tu ekosystém: nástroje tretích strán postavené okolo OpenAI SDK, ako sú LangChain a LlamaIndex, fungujú okamžite a tím, ktorý už SDK pozná, sa nemusí učiť nič nové. Cenou za toto pohodlie je to, čo si videl vyššie: funkcie špecifické pre xAI idú stranou.

Kľúčové poznatky

  • Pridaj base_url="https://api.x.ai/v1" do konštruktora OpenAI()
  • Nahraď API kľúč a názov modelu
  • Premenné OPENAI_BASE_URL a OPENAI_API_KEY umožňujú migráciu bez zásahu do kódu
  • Niektoré parametre (penalizácie, stop) nie sú podporované pri modeloch na logické usudzovanie