De OpenAI SDK voor Grok
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de xAI-pagina Models: grok-4.7 (september 2026) is de opvolger van grok-4.5 als aanbevolen model; het voorbeeld, geschreven voor grok-4.5, werkt ook met grok-4.7. Bronnen: Models · Release notes.
Verduidelijkt op 3 november 2026, gebaseerd op de xAI-referentie voor Chat Completions: de aanroep is niet strikt identiek aan die van OpenAI;
logprobsentop_logprobs(genegeerd vanafgrok-4.20) enlogit_bias(niet ondersteund) vergroten de hieronder genoemde verschillen. Bron: xAI, Chat Completions.
Gebruik uw kennis van OpenAI opnieuw
Als u al met de OpenAI SDK in Python werkt, kunt u deze ongewijzigd gebruiken om de Grok API aan te roepen. U hoeft alleen de basis-URL te wijzigen om verzoeken naar de servers van xAI om te leiden. Dit is de snelste aanpak als u al bestaande code heeft.
Installatie
Als de OpenAI SDK nog niet in uw project is geïnstalleerd:
pip install openai
De client configureren voor xAI
Het enige verschil met normaal gebruik van OpenAI is de 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"
)
Dat is alles. Vanaf dit punt werkt elke methode in de OpenAI SDK met de Grok-modellen.
Een bericht verzenden
De aanroep heeft dezelfde structuur als voor GPT, met uitzondering van niet-ondersteunde parameters (zie hieronder):
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)
Beschikbare modellen
Vervang simpelweg de OpenAI-modelnaam door een Grok-model:
grok-4.7: het door xAI aanbevolen model, veelzijdig, met ondersteuning voor beeldinvoer (grok-4.6engrok-4.5blijven beschikbaar)grok-4.20-0309-reasoning: geavanceerde redeneervaardighedengrok-4.3: snelle, goedkope antwoorden (1M context)
Een bestaand OpenAI-project migreren
Om een bestaand project aan te passen, heeft u twee opties.
Optie 1: Omgevingsvariabelen
Wijzig uw variabelen zonder de code aan te passen:
export OPENAI_API_KEY="xai-your-key"
export OPENAI_BASE_URL="https://api.x.ai/v1"
De OpenAI SDK leest deze variabelen automatisch. Uw bestaande code werkt als u ook de modelnaam wijzigt en de parameters verwijdert die xAI niet ondersteunt.
Optie 2: Expliciete configuratie
Schrijf een initialisatiefunctie die schakelt tussen providers:
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() # Standaard OpenAI
client = create_client("xai")
Met deze aanpak kunt u tijdens de migratie eenvoudig schakelen tussen providers.
Verschillen om rekening mee te houden
Hoewel de API compatibel is, vertoont sommige gedragingen verschillen:
- De parameters
frequency_penaltyenpresence_penaltyworden niet ondersteund op redeneermodellen - De parameter
stopis niet beschikbaar op redeneermodellen logprobsentop_logprobsworden stilzwijgend genegeerd doorgrok-4.20en nieuwere modellen, enlogit_biaswordt niet ondersteund- Modelnamen zijn uiteraard anders
- Sommige xAI-functies (X-zoekopdracht, webzoekopdracht) zijn niet beschikbaar via het standaard OpenAI-formaat
Wanneer kiest u voor deze aanpak?
De compatibiliteitsmodus is het meest zinvol wanneer uw bestaande code belangrijker is dan exclusieve functies. De meest voorkomende casus is migratie: code die al voor OpenAI is geschreven, schakelt over naar Grok door de basis-URL en de sleutel te wijzigen: twee regels, geen herschrijving. Omkeerbaarheid is ook belangrijk: zolang u het OpenAI-formaat hanteert, blijft het wisselen van provider een kwestie van configuratie, wat waardevol is voor het vergelijken van modellen of onderhandelingen. Dan is er nog het ecosysteem: tools van derden die rond de OpenAI SDK zijn gebouwd, zoals LangChain en LlamaIndex, werken direct, en een team dat de SDK al kent, hoeft niets nieuws te leren. De prijs die u betaalt, is degene die u hierboven zag: xAI-specifieke functies komen op de tweede plaats.
Belangrijkste punten
- Voeg
base_url="https://api.x.ai/v1"toe aan de constructorOpenAI() - Vervang de API-sleutel en de modelnaam
- De variabelen
OPENAI_BASE_URLenOPENAI_API_KEYmaken een migratie mogelijk zonder de code aan te passen - Sommige parameters (straffen, stop) worden niet ondersteund op redeneermodellen