Grok 4.7 is het nieuwste en krachtigste model op de xAI API, en je roept het binnen een paar minuten aan vanuit een terminal of een kort script. Deze handleiding laat je zien hoe je een sleutel aanmaakt, een eerste verzoek stuurt met curl, Python en JavaScript, en daarna de functies gebruikt die je als volgende wilt: redeneerniveau, vervolgvragen, live webzoeken, kostenoverzicht en de nieuwe contentrichtlijnen. De commando’s volgen de officiële documentatie op docs.x.ai, gecontroleerd op 15 november 2026.
Belangrijkste punten
- Grok 4.7 is het krachtigste model op de xAI API, met een contextvenster van 500.000 tokens.
- Maak een sleutel aan op console.x.ai, sla die op als XAI_API_KEY en roep de Responses API aan met curl of de OpenAI SDK.
- Stel het redeneerniveau in van low tot xhigh, ga verder met chats via previous_response_id en voeg de tool web_search toe voor actuele antwoorden.
- Elk antwoord meldt de exacte prijs in cost_in_usd_ticks, en optionele richtlijnen weigeren nsfw, violence of profanity.
Een opmerking over de naam: de documentatie noemt het bedrijf nu SpaceXSI, maar de dienst heet nog steeds ’the xAI API’, het adres is nog steeds api.x.ai en de sleutelvariabele is nog steeds XAI_API_KEY.
Wat je nodig hebt
- Een account op console.x.ai met opgewaardeerd tegoed. Volgens de quickstart moet je tegoed opwaarderen voordat je de API gebruikt.
- Een terminal met
curl. Dat is genoeg voor de hele handleiding. - Optioneel: Python met
pip, of Node.js metnpm, als je de API vanuit code wilt aanroepen.
Grok 4.7 in één oogopslag
Deze cijfers komen van de Grok 4.7-pagina en de prijspagina, stand 15 november 2026. Prijzen veranderen, dus controleer ze voordat je een budget maakt.
| Eigenschap | Waarde |
|---|---|
| Modelnaam | grok-4.7 |
| Contextvenster | 500.000 tokens |
| Kennisgrens | Mei 2026 |
| Invoer | Tekst en afbeeldingen |
| Uitvoer | Tekst |
| Prijs, prompts onder 200k tokens | $ 2,00 invoer, $ 0,50 gecachete invoer, $ 6,00 uitvoer per 1 mln. tokens |
| Prijs, prompts van 200k tokens of meer | $ 4,00 invoer, $ 1,00 gecachete invoer, $ 12,00 uitvoer per 1 mln. tokens |
| Redeneerniveau | low, medium, high (standaard) of xhigh |
In cijfers
500.000 tokenscontextvenster
$ 2,00invoer per 1 mln. tokens, onder 200k
$ 6,00uitvoer per 1 mln. tokens, onder 200k
Stap 1: Maak een API-sleutel aan
- Log in op console.x.ai en waardeer tegoed op.
- Open de pagina API Keys en maak een sleutel aan.
- Sla hem op in een omgevingsvariabele, zodat hij nooit in je code staat:
export XAI_API_KEY="your_api_key"
In Windows PowerShell gebruik je in plaats daarvan $env:XAI_API_KEY="your_api_key". Behandel de sleutel als een wachtwoord. Plak hem niet in gedeelde documenten en commit hem niet naar een repository.
Stap 2: Stuur je eerste verzoek met curl
De documentatie raadt de Responses API aan, op https://api.x.ai/v1/responses. Dit is het voorbeeld uit de quickstart:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
}'
Verwacht resultaat: een JSON-object. Het antwoord staat in de lijst output, in een item van het type message waarvan de inhoud het type output_text heeft. Hetzelfde object bevat een id (die gebruik je in stap 5) en een usage-blok met het aantal tokens.

Stap 3: Roep het aan vanuit Python of JavaScript
De API werkt met de OpenAI SDK’s als je ze naar de basis-URL van xAI laat wijzen. Installeer er een:
pip install openai
npm install openai
Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1",
)
response = client.responses.create(
model="grok-4.7",
input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)
print(response.output_text)
JavaScript (sla het op als .mjs-bestand, zodat import en await op het hoogste niveau werken in Node.js):
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: process.env.XAI_API_KEY,
baseURL: 'https://api.x.ai/v1',
});
const response = await client.responses.create({
model: 'grok-4.7',
input: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',
});
console.log(response.output_text);
Beide tonen alleen de tekst van het model. xAI heeft ook een eigen Python-pakket (pip install xai-sdk), en volgens de documentatie kun je die twee gerust combineren.
Stap 4: Kies hoe hard het model nadenkt
Grok 4.7 redeneert altijd voordat het antwoordt. Uitzetten kan niet, maar met de handleiding over redeneren stel je de inspanning in. De standaard is high. Gebruik low voor snelle, eenvoudige aanroepen en xhigh voor de lastigste problemen, waar een trager antwoord geen probleem is.
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-m 3600 \
-d '{
"model": "grok-4.7",
"reasoning": {"effort": "low"},
"input": "Summarise the difference between TCP and UDP in three bullet points."
}'
Met de vlag -m 3600 mag het verzoek tot een uur lopen voordat curl opgeeft. De documentatie gebruikt die in de redeneervoorbeelden, omdat diep redeneren even kan duren. In Python is dezelfde instelling reasoning={"effort": "low"}.

Stap 5: Stel een vervolgvraag zonder de chat opnieuw te sturen
Volgens de handleiding over tekstgeneratie bewaart de Responses API elke uitwisseling standaard 30 dagen op de servers van xAI. Daardoor kun je een gesprek voortzetten door de id van het eerdere antwoord mee te geven:
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-m 3600 \
-d '{
"model": "grok-4.7",
"previous_response_id": "The previous response ID",
"input": [
{
"role": "user",
"content": "How do stars form?"
}
]
}'
Vervang de placeholder door de id uit je eerdere antwoord. Wil je liever niet dat verzoeken worden opgeslagen, voeg dan "store": false toe aan het verzoek en houd de geschiedenis zelf bij.
Wist je dat?
Standaard bewaart de Responses API elke uitwisseling 30 dagen op de servers van xAI. Voeg “store”: false toe aan een verzoek als je de gespreksgeschiedenis liever zelf bijhoudt.
Stap 6: Laat Grok op het web zoeken
De modellenpagina zegt het ronduit: zonder zoektools weet Grok niets buiten zijn trainingsdata. Voor actuele antwoorden voeg je de tool voor webzoeken toe:
curl https://api.x.ai/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{
"model": "grok-4.7",
"input": [
{
"role": "user",
"content": "What were the main technology headlines this week?"
}
],
"tools": [
{
"type": "web_search"
}
]
}'
Grok bepaalt zelf hoeveel zoekopdrachten het uitvoert. Op 15 november 2026 kost webzoeken $ 5 per 1.000 aanroepen bovenop de normale tokenkosten, dus een prompt met veel onderzoek kost meer dan een gewone.
Stap 7: Bekijk wat elk verzoek kostte
Elk antwoord meldt de exacte prijs in een veld met de naam cost_in_usd_ticks, beschreven in de handleiding over kostenoverzicht. Eén Amerikaanse dollar is 10.000.000.000 ticks. Als je jq hebt geïnstalleerd, toont dit het getal voor één aanroep:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Say hello"
}' | jq '.usage.cost_in_usd_ticks'
Deel het resultaat door 10.000.000.000 om dollars te krijgen. Het voorbeeld uit de documentatie: 37756000 ticks is ongeveer $ 0,0038.
Wist je dat?
xAI rekent verzoeken af in ticks: één Amerikaanse dollar is 10.000.000.000 ticks. Het voorbeeld uit de documentatie van 37756000 ticks komt neer op ongeveer $ 0,0038.
Stap 8 (optioneel): Voeg contentrichtlijnen toe
In oktober 2026 voegde xAI eigen moderatie-instellingen toe. Je hangt een guidelines-lijst aan een verzoek, en Grok weigert dat soort content al tijdens het schrijven. Er zijn drie categorieën, nsfw, violence en profanity, en het enige gedrag is op dit moment decline.
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Write a short story about a knight.",
"guidelines": [
{ "type": "policy", "category": "violence", "behavior": "decline" },
{ "type": "policy", "category": "nsfw", "behavior": "decline" }
]
}'
Richtlijnen gelden alleen voor het verzoek waarin ze zitten, dus stuur ze elke keer mee. Met de OpenAI Python SDK geef je de lijst mee in extra_body, omdat die SDK geen eigen guidelines-parameter heeft.
Veelvoorkomende fouten en oplossingen
De statuscodes hieronder komen van de debugpagina van xAI en uit de handleidingen die hierboven gelinkt staan.
| Wat je ziet | Waarschijnlijke oorzaak | Oplossing |
|---|---|---|
401 Unauthorized | Geen authorization-header, of een ongeldige sleutel | Stuur Authorization: Bearer <your key> en controleer met echo $XAI_API_KEY of de variabele is ingesteld |
400 Bad Request | Een ongeldig argument in de body of URL, of een onjuiste API-sleutel | Controleer de JSON, het endpointadres en de sleutel |
403 Forbidden | Je sleutel of team heeft geen toestemming, of is geblokkeerd | Vraag de beheerder van je team om toestemming |
404 Not Found | Het model in het verzoek is niet gevonden, of de URL is verkeerd gespeld | Controleer de spelling grok-4.7 en het endpointadres |
415 Unsupported Media Type | Lege body, of de header Content-Type: application/json ontbreekt | Voeg de header en een geldige body toe |
422 Unprocessable Entity | Een veld heeft een ongeldig formaat, bijvoorbeeld een onbekende guidelines-categorie | Controleer het veld aan de hand van de documentatie. Bij richtlijnen noemt de foutmelding de geldige waarden |
429 Too Many Requests | Je hebt een rate limit bereikt | Doe rustiger aan en probeer opnieuw met een steeds langere wachttijd. Limieten stijgen automatisch met de totale uitgaven van je team |
Fout als je stop, een presence penalty of een frequency penalty instelt | Redeneermodellen accepteren deze niet | Verwijder ze |
| Het verzoek loopt in een time-out | Het redeneren duurde langer dan je client toestaat | Verhoog de time-out van je client (de voorbeelden in de documentatie gebruiken 3.600 seconden) of verlaag het redeneerniveau |
Als alles tegelijk misgaat, kijk dan eerst op status.x.ai voordat je je eigen code gaat debuggen.
Afronding
Je hebt nu een werkende sleutel, een eerste verzoek en vijf instellingen die de meeste projecten nodig hebben: redeneerniveau, opgeslagen gesprekken, webzoeken, kosten per verzoek en contentrichtlijnen. De documentatie behandelt ook streaming, gestructureerde output, bestandsuploads en function calling.
Vergelijk je aanbieders? Onze handleiding voor de Gemini 4 Hydrogen API volgt dezelfde stappen voor het model van Google. Houd je alles liever op je eigen computer, lees dan hoe je een model lokaal draait met Ollama. En wil je Grok liever in je calls dan in je code, dan lees je hier hoe je Grok toevoegt aan Zoom, Google Meet of Teams.
Veelgestelde vragen
Wat kost de Grok 4.7 API?
Voor prompts onder 200k tokens: $ 2,00 invoer, $ 0,50 gecachete invoer en $ 6,00 uitvoer per 1 mln. tokens. Prompts van 200k tokens of meer kosten het dubbele. Webzoeken kost $ 5 extra per 1.000 aanroepen. Prijzen volgens de stand van 15 november 2026.
Kan ik de OpenAI SDK gebruiken met de Grok API?
Ja. Laat de OpenAI SDK voor Python of JavaScript met je XAI_API_KEY naar de basis-URL https://api.x.ai/v1 wijzen en roep responses.create aan met het model grok-4.7. xAI heeft ook een eigen pakket xai-sdk, en volgens de documentatie kun je ze gerust combineren.
Waarom loopt mijn Grok API-verzoek in een time-out?
Grok 4.7 redeneert altijd voordat het antwoordt, en diep redeneren kan even duren. Verhoog de time-out van je client (de voorbeelden in de documentatie gebruiken 3.600 seconden) of verlaag het redeneerniveau.
Kan Grok 4.7 het redeneren uitzetten?
Nee. Grok 4.7 redeneert altijd voordat het antwoordt. Je kunt alleen het niveau instellen op low, medium, high of xhigh, en high is de standaard.
Korte quiz
Wat is het standaard redeneerniveau van Grok 4.7?
- low (laag)
- medium (gemiddeld)
- high (hoog)
De handleiding over redeneren stelt high in als standaard.
Hoeveel ticks vormen één Amerikaanse dollar?
- 10,000,000,000
- 1,000,000
- 37,756,000
Volgens de handleiding over kostenoverzicht is één Amerikaanse dollar 10.000.000.000 ticks.
Wat betekent een 401 Unauthorized-fout meestal?
- Je hebt een rate limit bereikt
- Een ontbrekende header of een ongeldige sleutel
- De modelnaam is verkeerd gespeld
De debugpagina van xAI noemt een ontbrekende authorization-header of een ongeldige sleutel als oorzaak.
Bronnen
Links voor het laatst gecontroleerd op 15 november 2026.





Schrijf een reactie