OpenAI SDK pre Grok
Na tejto strane
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
logprobsatop_logprobs(ignorované od verziegrok-4.20) alogit_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 (modelygrok-4.6agrok-4.5zostávajú dostupné)grok-4.20-0309-reasoning: pokročilé logické usudzovaniegrok-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_penaltyapresence_penaltynie sú podporované pri modeloch na logické usudzovanie - Parameter
stopnie je dostupný pri modeloch na logické usudzovanie logprobsatop_logprobssú modelmigrok-4.20a novšími ticho ignorované alogit_biasnie 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štruktoraOpenAI() - Nahraď API kľúč a názov modelu
- Premenné
OPENAI_BASE_URLaOPENAI_API_KEYumožňujú migráciu bez zásahu do kódu - Niektoré parametre (penalizácie, stop) nie sú podporované pri modeloch na logické usudzovanie