OpenAI SDK s base_url od xAI
Na této stránce
Aktualizováno 3. listopadu 2026. Podle reference k Chat Completions od xAI není kompatibilita s OpenAI SDK „100%“ – několik parametrů není podporováno modely pro uvažování (reasoning models), jsou ignorovány nejnovějšími modely nebo nejsou podporovány žádným modelem. Zdroj: xAI, Chat Completions.
Použití OpenAI SDK pro přístup ke Grok
Jednou z hlavních výhod koncového bodu Chat Completions od xAI je jeho kompatibilita s OpenAI SDK. Můžeš použít balíček openai, který již znáš, a pouze změnit base_url tak, aby směřoval na servery xAI.
Tento přístup je ideální, pokud migruješ existující aplikaci z OpenAI na Grok, nebo pokud chceš přepínat mezi poskytovateli s minimálními změnami.
Konfigurace
Instalace je stejná jako u jakéhokoli projektu využívajícího OpenAI SDK:
pip install openai
Jediný rozdíl spočívá ve vytvoření klienta, kde zadáš základní URL a API klíč xAI:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
Dva zásadní parametry jsou:
api_key: Tvůj API klíč xAI (nikoli klíč od OpenAI)base_url:https://api.x.ai/v1– toto přesměruje požadavky na xAI místo na OpenAI
Volání totožná s OpenAI
Jakmile je klient nakonfigurován, používá se stejně jako standardní OpenAI SDK – s výjimkou parametrů, které xAI nepodporuje a které jsou podrobně popsány níže:
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ý viditelný rozdíl je název modelu: grok-4.20-0309-reasoning místo například gpt-5.6.
Streamování s OpenAI SDK
Streamování funguje naprosto stejně:
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 pro Node.js funguje stejným způsobem:
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 vlastnost se v JavaScriptu jmenuje baseURL (velké U), zatímco v Pythonu je to base_url.
Přepínání mezi poskytovateli
Hlavní výhodou tohoto přístupu je možnost změnit poskytovatele pomocí jediné proměnné:
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"])
Tato architektura s více poskytovateli je běžná v produkčních aplikacích, které chtějí zachovat flexibilitu.
Co se mezi poskytovateli nepřenáší
Kompatibilní neznamená totožné. Reference koncového bodu xAI upozorňuje na několik parametrů, které modely pro uvažování nepodporují – frequency_penalty, presence_penalty (jako u grok-3) a stop. Parametry logprobs a top_logprobs jsou modely grok-4.20 a novějšími ignorovány bez chyby a logit_bias není podporován vůbec. Kód, který tyto parametry nastavuje pro OpenAI, bude nutné pro Grok odstranit. Pole, která jsou tiše ignorována, jsou nejzrádnější, protože nic nenaznačuje, že nemají žádný efekt. Hostované nástroje se také mezi poskytovateli liší: webové vyhledávání od OpenAI není totéž co u xAI. Nakonec, xAI nyní klasifikuje Chat Completions jako zastaralý koncový bod a doporučuje API Responses (lekce 11 a 12).
Klíčové poznatky
- OpenAI SDK funguje s xAI pouhou změnou
base_urlnahttps://api.x.ai/v1 - Metody a formáty odpovědí jsou stejné, ale některé parametry nejsou podporovány (
frequency_penalty,presence_penalty,stopu modelů pro uvažování,logit_bias) nebo jsou ignorovány (logprobsod verzegrok-4.20výše) - Přizpůsob API klíč, název modelu a nepodporované parametry
- Tento přístup zjednodušuje migraci z OpenAI a umožňuje přepínání mezi poskytovateli
- Streamování a typování OpenAI SDK fungují; hostované nástroje jsou specifické pro každého poskytovatele