Zo gebruik je de Grok 4.7 API: stap-voor-stap met curl, Python en JavaScript

Maak een xAI API-sleutel aan en stuur je eerste verzoek naar Grok 4.7. Voeg daarna redeneerniveau, vervolgvragen, webzoeken, kostenoverzicht en contentrichtlijnen toe.

Graphic of a terminal window sending a request to a cloud and getting a reply, for a guide to the Grok 4.7 API

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 met npm, 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.

EigenschapWaarde
Modelnaamgrok-4.7
Contextvenster500.000 tokens
KennisgrensMei 2026
InvoerTekst en afbeeldingen
UitvoerTekst
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
Redeneerniveaulow, 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

  1. Log in op console.x.ai en waardeer tegoed op.
  2. Open de pagina API Keys en maak een sleutel aan.
  3. Sla hem op in een omgevingsvariabele, zodat hij nooit in je code staat:
Terminal
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:

Terminal
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.

Stroomdiagram van het opwaarderen van xAI-tegoed en het aanmaken van een API-sleutel tot het lezen van het eerste antwoord van Grok 4.7

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:

Terminal
pip install openai
Terminal
npm install openai

Python:

Code
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):

Code
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.

Terminal
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"}.

Overzicht van de redeneerniveaus van Grok 4.7 van low tot xhigh, met high gemarkeerd als standaard

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:

Terminal
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:

Terminal
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:

Terminal
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.

Terminal
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 zietWaarschijnlijke oorzaakOplossing
401 UnauthorizedGeen authorization-header, of een ongeldige sleutelStuur Authorization: Bearer <your key> en controleer met echo $XAI_API_KEY of de variabele is ingesteld
400 Bad RequestEen ongeldig argument in de body of URL, of een onjuiste API-sleutelControleer de JSON, het endpointadres en de sleutel
403 ForbiddenJe sleutel of team heeft geen toestemming, of is geblokkeerdVraag de beheerder van je team om toestemming
404 Not FoundHet model in het verzoek is niet gevonden, of de URL is verkeerd gespeldControleer de spelling grok-4.7 en het endpointadres
415 Unsupported Media TypeLege body, of de header Content-Type: application/json ontbreektVoeg de header en een geldige body toe
422 Unprocessable EntityEen veld heeft een ongeldig formaat, bijvoorbeeld een onbekende guidelines-categorieControleer het veld aan de hand van de documentatie. Bij richtlijnen noemt de foutmelding de geldige waarden
429 Too Many RequestsJe hebt een rate limit bereiktDoe 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 insteltRedeneermodellen accepteren deze nietVerwijder ze
Het verzoek loopt in een time-outHet redeneren duurde langer dan je client toestaatVerhoog 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.

Geschreven door Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Over Mindloop Experience

Reacties

Schrijf een reactie

Meer van Mindloop Experience

Alles van Mindloop Experience bekijken

Je kunt tot 50 keer klappen.