OpenAI SDK pro Grok
Na této stránce
Aktualizováno 3. listopadu 2026 na základě stránky Models od xAI: model grok-4.7 (září 2026) nahradil grok-4.5 jako doporučený model; příklad napsaný pro grok-4.5 funguje také s grok-4.7. Zdroje: Models · Release notes.
Upřesněno 3. listopadu 2026 na základě reference xAI Chat Completions: volání není zcela totožné s OpenAI; parametry
logprobsatop_logprobs(od verzegrok-4.20ignorovány) alogit_bias(nepodporován) rozšiřují níže uvedené rozdíly. Zdroj: xAI, Chat Completions.
Využij své znalosti OpenAI
Pokud již pracuješ s OpenAI SDK v Pythonu, můžeš jej použít tak, jak je, pro volání Grok API. Stačí přesměrovat požadavky na servery xAI změnou základní URL. Je to nejrychlejší přístup, pokud máš existující kód.
Instalace
Pokud ještě nemáš v projektu nainstalované OpenAI SDK:
pip install openai
Konfigurace klienta pro xAI
Jediný rozdíl oproti běžnému použití OpenAI spočívá v parametru 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še. Od této chvíle fungují všechny metody OpenAI SDK s modely Grok.
Odeslání zprávy
Volání má stejnou strukturu jako u GPT, kromě nepodporovaných parametrů (viz níže):
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čí nahradit název modelu OpenAI názvem modelu Grok:
grok-4.7: model doporučený společností xAI, všestranný, podporuje vstupní obrázky (modelygrok-4.6agrok-4.5zůstávají k dispozici)grok-4.20-0309-reasoning: pokročilé logické uvažovánígrok-4.3: rychlé a levné odpovědi (kontext 1M)
Migrace existujícího projektu OpenAI
Pro úpravu stávajícího projektu máš dvě možnosti.
Možnost 1: Proměnné prostředí
Změň proměnné 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 tyto proměnné načte automaticky. Tvůj existující kód bude fungovat, pokud také změníš název modelu a odstraníš parametry, které xAI nepodporuje.
Možnost 2: Explicitní konfigurace
Napiš inicializační funkci, která přepíná mezi poskytovateli:
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() # Ve výchozím nastavení OpenAI
client = create_client("xai")
Tento přístup ti umožňuje snadno přepínat mezi poskytovateli během migrace.
Rozdíly, které musíš znát
Ačkoli je API kompatibilní, některé behaviorální aspekty se liší:
- Parametry
frequency_penaltyapresence_penaltynejsou podporovány u modelů pro logické uvažování (reasoning) - Parametr
stopnení u modelů pro logické uvažování k dispozici - Parametry
logprobsatop_logprobsjsou u modelůgrok-4.20a novějších tiše ignorovány alogit_biasnení podporován - Názvy modelů jsou samozřejmě odlišné
- Některé funkce xAI (vyhledávání na X, webové vyhledávání) nejsou prostřednictvím standardního formátu OpenAI dostupné
Kdy tento přístup zvolit
Režim kompatibility dává největší smysl, když je pro tebe důležitější existující kód než exkluzivní funkce. Nejčastějším případem je migrace: kód již napsaný pro OpenAI přejde na Grok změnou základní URL a klíče: dva řádky, žádný přepis. Důležitá je také reverzibilita: dokud zůstaneš u formátu OpenAI, zůstává přepínání poskytovatelů záležitostí konfigurace, což je cenné pro porovnávání modelů nebo vyjednávání. Pak je tu ekosystém: nástroje třetích stran postavené kolem OpenAI SDK, jako jsou LangChain a LlamaIndex, fungují okamžitě a tým, který již SDK zná, se nemusí učit nic nového. Cenou za to je výše zmíněné: funkce specifické pro xAI ustupují do pozadí.
Klíčové poznatky
- Přidej
base_url="https://api.x.ai/v1"do konstruktoruOpenAI() - Nahraď API klíč a název modelu
- Proměnné
OPENAI_BASE_URLaOPENAI_API_KEYumožňují migraci bez zásahu do kódu - Některé parametry (penalizace, stop) nejsou u modelů pro logické uvažování podporovány