OpenAI SDK met xAI base_url
Op deze pagina
Bijgewerkt op 3 november 2026. Volgens de referentiedocumentatie voor xAI Chat Completions is de compatibiliteit met de OpenAI SDK niet “100%”: bepaalde parameters worden niet ondersteund door redeneermodellen, genegeerd door recente modellen, of worden door geen enkel model ondersteund. Bron: xAI, Chat Completions.
De OpenAI SDK gebruiken voor toegang tot Grok
Een van de grootste voordelen van het xAI Chat Completions-eindpunt is de compatibiliteit met de OpenAI SDK. U kunt het openai-pakket gebruiken dat u al kent, waarbij u eenvoudigweg de base_url wijzigt om naar de xAI-servers te verwijzen.
Deze aanpak is ideaal als u een bestaande applicatie migreert van OpenAI naar Grok, of als u met minimale wijzigingen tussen providers wilt schakelen.
Configuratie
De installatie verloopt hetzelfde als bij elk project dat de OpenAI SDK gebruikt:
pip install openai
Het enige verschil zit in het aanmaken van de client, waarbij u de basis-URL en de xAI API-sleutel opgeeft:
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
De twee essentiële parameters zijn:
api_key: Uw xAI API-sleutel (geen OpenAI-sleutel)base_url:https://api.x.ai/v1– dit stuurt verzoeken door naar xAI in plaats van naar OpenAI
Oproepen identiek aan OpenAI
Zodra de client is geconfigureerd, is het gebruik hetzelfde als bij de standaard OpenAI SDK, met uitzondering van de parameters die xAI niet ondersteunt (zie hieronder voor details):
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)
Het enige zichtbare verschil is de modelnaam: grok-4.20-0309-reasoning in plaats van bijvoorbeeld gpt-5.6.
Streaming met de OpenAI SDK
Streaming werkt op exact dezelfde manier:
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
De OpenAI SDK voor Node.js werkt op dezelfde wijze:
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);
Merk op dat de eigenschap in JavaScript baseURL is (met hoofdletter U), terwijl dit in Python base_url is.
Schakelen tussen providers
Het grootste voordeel van deze aanpak is de mogelijkheid om met één variabele van provider te wisselen:
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"])
Deze multi-provider architectuur komt veel voor in productieomgevingen waar flexibiliteit gewenst is.
Wat niet zonder meer overdraagbaar is tussen providers
Compatibel betekent niet identiek. De referentiedocumentatie van het xAI-eindpunt wijst op verschillende parameters die niet worden ondersteund door redeneermodellen: frequency_penalty, presence_penalty (zoals bij grok-3) en stop. logprobs en top_logprobs worden genegeerd zonder foutmelding door grok-4.20 en nieuwere modellen, en logit_bias wordt niet ondersteund. Code die deze parameters voor OpenAI instelt, moet ze voor Grok verwijderen. Stil genegeerde velden zijn het verraderlijkst, omdat niets aangeeft dat ze geen effect hebben. Ook gehoste tools verschillen per provider: de webzoekfunctie van OpenAI is niet die van xAI. Tot slot classificeert xAI Chat Completions inmiddels als een verouderd eindpunt en beveelt het de Responses API aan (lessen 11 en 12).
Belangrijkste punten
- De OpenAI SDK werkt met xAI door simpelweg de
base_urlte wijzigen naarhttps://api.x.ai/v1 - Methoden en responsformaten zijn hetzelfde, maar sommige parameters worden niet ondersteund (
frequency_penalty,presence_penalty,stopbij redeneermodellen,logit_bias) of worden genegeerd (logprobsvanafgrok-4.20) - Pas de API-sleutel, modelnaam en niet-ondersteunde parameters aan
- Deze aanpak vereenvoudigt migratie vanaf OpenAI en maakt schakelen tussen providers mogelijk
- Streaming en typering via de OpenAI SDK werken; gehoste tools zijn specifiek voor elke provider