Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

OpenAI SDK met xAI base_url

Les 5 van 12 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De OpenAI SDK gebruiken voor toegang tot Grok
  2. Configuratie
  3. Oproepen identiek aan OpenAI
  4. Streaming met de OpenAI SDK
  5. JavaScript / TypeScript
  6. Schakelen tussen providers
  7. Wat niet zonder meer overdraagbaar is tussen providers
  8. Belangrijkste punten

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_url te wijzigen naar https://api.x.ai/v1
  • Methoden en responsformaten zijn hetzelfde, maar sommige parameters worden niet ondersteund (frequency_penalty, presence_penalty, stop bij redeneermodellen, logit_bias) of worden genegeerd (logprobs vanaf grok-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