Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De OpenAI SDK voor Grok

Les 6 van 14 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Gebruik uw kennis van OpenAI opnieuw
  2. Installatie
  3. De client configureren voor xAI
  4. Een bericht verzenden
  5. Een bestaand OpenAI-project migreren
  6. Verschillen om rekening mee te houden
  7. Wanneer kiest u voor deze aanpak?
  8. Belangrijkste punten

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; logprobs en top_logprobs (genegeerd vanaf grok-4.20) en logit_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.6 en grok-4.5 blijven beschikbaar)
  • grok-4.20-0309-reasoning: geavanceerde redeneervaardigheden
  • grok-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_penalty en presence_penalty worden niet ondersteund op redeneermodellen
  • De parameter stop is niet beschikbaar op redeneermodellen
  • logprobs en top_logprobs worden stilzwijgend genegeerd door grok-4.20 en nieuwere modellen, en logit_bias wordt 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 constructor OpenAI()
  • Vervang de API-sleutel en de modelnaam
  • De variabelen OPENAI_BASE_URL en OPENAI_API_KEY maken een migratie mogelijk zonder de code aan te passen
  • Sommige parameters (straffen, stop) worden niet ondersteund op redeneermodellen