Grok API: Grok aanroepen vanuit je eigen code

Twee manieren om Grok via code te gebruiken

Ontwikkelaars kunnen Grok-modellen op twee manieren aanroepen. De eerste is de xAI API, beheerd door het bedrijf zelf (inmiddels opererend onder de naam SpaceXSI), met API-sleutels via console.x.ai. De tweede is een model-router zoals OpenRouter, die modellen van allerlei aanbieders bundelt onder één API-sleutel en één factuur. Beide ondersteunen het OpenAI Chat Completions-formaat, waardoor de officiële OpenAI-SDK's direct werken zodra je het basisadres en de modelnaam aanpast.

Welke optie kies je?

• xAI API als je als eerste toegang wilt tot alle Grok-functies: de complete modellenlijst, de Responses API, server-side tools voor zoeken op het web en op X, beeld- en videogeneratie via Grok Imagine, spraak, batchverwerking en kortingen op gecachte prompts. Basis-URL: https://api.x.ai/v1.
• OpenRouter als je eenvoudig wilt wisselen tussen Grok en modellen van andere aanbieders zonder aparte contracten, of als je al een OpenRouter-account hebt. Basis-URL: https://openrouter.ai/api/v1, met model-ID's voorafgegaan door x-ai/. De installatie vind je in de OpenRouter-snelstartgids.

Sla je API-sleutel in beide gevallen altijd veilig op op een server of in een omgevingsvariabele. Neem hem nooit op in de broncode van een webpagina of mobiele app, waar iedereen hem kan inzien.

Je eerste verzoek aan de xAI API

Maak een sleutel aan in de console, sla deze op als XAI_API_KEY en stuur een bericht naar Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "Je bent een beknopte assistent."},
      {"role": "user", "content": "Geef me drie tips voor mijn eerste marathon."}
    ]
  }'

Python (met de OpenAI-bibliotheek)

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Is 391 een priemgetal? Laat je berekening zien."}],
)
print(answer.choices[0].message.content)

Met reasoning_effort bepaal je hoe lang het model nadenkt voordat het antwoordt. Grok 4.3 ondersteunt none, low, medium, high en xhigh (standaard: low); Grok 4.7 ondersteunt low, medium, high en xhigh (standaard: high). Voor Grok 4.20 hanteert xAI aparte ID's: grok-4.20-0309-reasoning en grok-4.20-0309-non-reasoning.

Hetzelfde via OpenRouter

Sla bij OpenRouter je sleutel op in OPENROUTER_API_KEY en gebruik de x-ai/ model-ID's. OpenRouter regelt het denkproces via een reasoning-object. Dit JavaScript-voorbeeld werkt in Node.js 18 of nieuwer:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Herschrijf deze kop op een rustigere toon: PRIJZEN EXPLODEREN OPNIEUW" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Wil je het model laten nadenken? Gebruik dan reasoning: { effort: "low" } (of medium, high). Voeg exclude: true toe als je wilt dat de denkstappen wel worden gebruikt, maar niet worden teruggestuurd. Zet stream: true om het antwoord realtime te ontvangen terwijl het wordt gegenereerd, wat in een chatinterface veel sneller aanvoelt.

Een afbeelding meesturen

Grok 4.20, 4.3 en 4.7 kunnen allemaal afbeeldingen analyseren. Gebruik hiervoor het OpenAI-formaat met meerdere onderdelen in het bericht. Volgens de documentatie van xAI worden JPEG- en PNG-afbeeldingen tot 20 MiB ondersteund; zowel een openbare URL als een base64 data-URL werkt.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Maak een lijst van de artikelen en het totaalbedrag op deze bon."}
    ]
  }]
}

Grok model-ID's en prijzen

Dit zijn de actuele tekstmodellen die OpenRouter vermeldt voor SpaceXAI, inclusief contextvenster en prijzen per miljoen tokens (OpenRouter-catalogusprijs, okt 2026). De xAI API hanteert dezelfde basistarieven voor prompts van minder dan 200.000 tokens.

Enkele belangrijke details van xAI's modellen- en prijzenpagina (xAI-catalogusprijs, okt 2026):

• Lange prompts zijn duurder. Zodra een prompt 200.000 tokens bereikt, wordt het gehele verzoek gefactureerd tegen het hogere tarief: $ 4 / $ 12 voor Grok 4.7, $ 2,50 / $ 5 voor Grok 4.3 en 4.20.
• Gecachte invoer is goedkoper: $ 0,50 per miljoen voor Grok 4.7 en $ 0,20 voor Grok 4.3 en 4.20 bij herhaalde promptvoorvoegsels.
• Batchverwerking met flexibele levertijd krijgt korting; OpenRouter vermeldt x-ai/grok-4.3:batch voor $ 1 / $ 2.
• Verschillen in contextgrootte: OpenRouter geeft 2.000.000 tokens op voor Grok 4.20, terwijl xAI's eigen pagina 1.000.000 aangeeft.

Denktokens tellen mee als output. Daardoor kan een redeneermodel per antwoord duurder uitvallen dan de prijs per token doet vermoeden.

Handige tips

• Begin met Grok 4.20 non-reasoning voor chatten, herschrijven en data-extractie. Het is snel en voordelig. Schakel over naar Grok 4.3 of 4.7 wanneer kwaliteit bij complexe taken belangrijker is dan snelheid.
• Let op de kennisgrens. Grok 4.7 beschikt volgens xAI over kennis tot mei 2026. Geef recentere feiten direct mee in je prompt, of gebruik xAI's tools voor zoeken op het web en op X (gefactureerd per oproep).
• Gebruik een duidelijke systeemprompt met de gewenste rol, toon en uitvoerindeling. Vraag om JSON inclusief schema als je code het antwoord moet verwerken.
• Houd rekening met rate limits. Wacht even en probeer het opnieuw zodra je een 429-foutmelding ontvangt.
• Volg de richtlijnen. Het gebruiksbeleid van xAI is van toepassing op API-gebruik. Met het veld safety_identifier kun je verzoeken labelen per eindgebruiker.

Problemen oplossen

• 401 of 403: de sleutel ontbreekt, is ingetrokken of in de verkeerde omgeving geladen. Toon de eerste paar tekens op je server om te controleren of hij goed doorkomt.
• Model not found: controleer het voorvoegsel. OpenRouter verwacht x-ai/grok-4.7, xAI accepteert grok-4.7 zonder prefix.
• Lege of extreem trage antwoorden bij een redeneermodel betekenen meestal dat het tokenbudget volledig is opgegaan aan nadenken. Verlaag de effort of verhoog max_tokens.
• Afbeelding geweigerd: zet het bestand om naar JPEG of PNG en controleer of het binnen de maximale bestandsgrootte blijft.

Veelgestelde vragen

Is de Grok API compatibel met de OpenAI-SDK?

Ja. Stel de SDK in op https://api.x.ai/v1 met een xAI-sleutel, of op OpenRouter met een OpenRouter-sleutel, en geef een Grok model-ID op.

Is er een gratis Grok API?

Er is geen permanente gratis versie beschikbaar. Zowel xAI als OpenRouter rekenen af per token, al kosten korte tests vrijwel niets.

Kan ik afbeeldingen genereren met de Grok API?

Ja, via xAI's Grok Imagine-modellen op een apart endpoint voor afbeeldingen. Zie onze pagina over Grok Imagine. Onze webchat ondersteunt geen beeldgeneratie.

Welk Grok-model gebruikt Grok.Online?

Onze chat biedt via OpenRouter toegang tot Grok 4.20 (zonder redeneerfunctie), Grok 4.3 (met lage redeneerinspanning) en tot 10 berichten per dag met Grok 4.7.