De xAI-API voor ontwikkelaars
Op deze pagina
Grok integreren in uw applicaties
Alles wat u hebt geleerd om te doen in de Grok-interface, kan worden geactiveerd vanuit uw eigen code. De xAI-API brengt deze mogelijkheden naar uw apps, websites en services: het gesprek stopt met een plek zijn waar u naartoe gaat en wordt een functie die uw product aanroept.
Vereisten
Voordat u uw eerste regel code schrijft, hebt u vier dingen nodig:
- Een xAI-account aangemaakt op accounts.x.ai
- Een API-sleutel gegenereerd op console.x.ai
- Een ingestelde betaalmethode (om verder te gaan dan het gratis quotum)
- Een Python- of JavaScript-ontwikkelomgeving
De eerste twee dingen hebt u al gedaan in deze cursus: het account regelt de authenticatie en de sleutel identificeert uw applicatie bij de API. De betaalmethode komt pas in beeld zodra uw gebruik het gratis quotum overschrijdt, wat sneller gebeurt dan u denkt zodra een service continu draait. Wat de omgeving betreft: Python en JavaScript hebben de beste tools, maar omdat de API HTTP spreekt, volstaat elke taal die een verzoek kan verzenden.
Initiële instelling
De eerste stap is het veilig opslaan van uw API-sleutel in een omgevingsvariabele:
export XAI_API_KEY="xai-your-key-here"
Hardcode uw sleutel nooit in uw broncode. De reden is banaal: een sleutel die in een bestand staat, belandt vroeg of laat in een Git-repository, en een sleutel die naar een openbare repository wordt gepusht, wordt binnen enkele minuten geëxploiteerd door bots die commits scannen, terwijl de rekening op uw naam blijft staan.
Vervolgens kiest u een SDK. De native xAI-SDK voor Python installeert u met pip install xai-sdk. Als uw code al OpenAI aanroept, werkt de openai-bibliotheek zoals hij is, dankzij de compatibiliteit van het formaat. Aan de JavaScript-kant voegt u de Vercel AI-SDK toe met npm install ai @ai-sdk/xai, en deze integreert met React- en Next.js-apps.
Uw eerste verzoek
Met de native SDK neemt het maken van de client en het openen van een gesprek drie regels in beslag:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")
De route die compatibel is met OpenAI is net zo direct: alleen de base_url verandert ten opzichte van bestaande code, en daarom schakelen veel teams binnen enkele minuten over.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.5",
input="Leg machine learning in 3 zinnen aan mij uit."
)
Om te controleren of een sleutel werkt voordat u überhaupt code schrijft, gaat niets boven een aanroep via de commandoregel:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Hi, how are you?"
}'
Wat de API blootlegt
De basis is tekstgeneratie (conversationele antwoorden, schrijven, analyse), samen met een redeneermodus die complexe problemen stap voor stap oplost. Streaming voegt daar aan toe door het antwoord token voor token te leveren in plaats van te wachten tot de generatie is voltooid.
Een tweede set geeft toegang tot informatie: realtime web- en X-zoekopdrachten, en RAG, waarmee u documentcollecties doorzoekt die u hebt opgebouwd. Het multimodale aspect omvat het begrijpen van afbeeldingen die u verstrekt, het genereren van afbeeldingen en video’s met grok-imagine, en spraak, met gesproken gesprekken en TTS.
Tot slot maken drie mechanismen de API programmeerbaar in de strikte zin: function calling, waarmee het model uw eigen functies kan aanroepen; gestructureerde outputs, die bruikbare JSON garanderen zonder kwetsbare nabewerking; en server-side code-uitvoering.
Kies uw model
Redeneren verschilt per model. grok-4.7, het vlaggenschip, biedt configureerbaar redeneren: de parameter reasoning_effort (low, medium, high of xhigh) stelt per verzoek in hoe diep het model denkt. grok-4.3 blijft de budgetoptie met zeer lange context, tegen ongeveer de helft van de prijs. Er bestaan niet-redenerende versies van de modellen voor eenvoudige taken: herformulering of classificatie hebben geen interne beraadslaging nodig.
Naamgevingsconventies beïnvloeden de stabiliteit van uw applicatie:
grok-4.20: de nieuwste aanbevolen stabiele versiegrok-4.20-latest: de meest recente versie (kan veranderen)grok-4.20-0309: een versie vastgepind op een specifieke datum (9 maart)
In productie beschermt een vastgepinde versie uw prompts tegen stille wijzigingen in het model; latest is prima voor verkenning, zolang u accepteert dat het gedrag kan verschuiven.
Ratelimits en best practices
De API handhaaft ratelimits om de service stabiel te houden: op het instapniveau ongeveer 10 miljoen tokens per minuut en 1.800 verzoeken per minuut voor modellen zoals grok-4.3, en meer naarmate uw niveau stijgt. Modellen voor het genereren van afbeeldingen en video’s hebben hun eigen, veel lagere limieten, variërend van 30 tot 300 verzoeken per minuut afhankelijk van het model, dus houd ze in de gaten voor een service gericht op consumenten.
Enkele gewoonten maken het verschil tussen een prototype en een solide integratie. Schakel streaming in voor lange antwoorden, want dertig seconden staren naar een leeg scherm voelt als een storing. Geef een gespreks-ID door om te profiteren van caching. Routeer elke taak naar het juiste model: grok-4.3 voor eenvoudig volume, grok-4.20 voor redeneren. Handel fouten af met retries en exponentiële backoff, anders verandert een verkeerspiek in een lawine van geweigerde verzoeken. En houd uw gebruik in de gaten in de console voordat u aan het einde van de maand het totaal ontdekt.
Belangrijkste punten
- De xAI-API is compatibel met het OpenAI-formaat, wat migratie eenvoudig maakt
- Er zijn verschillende SDK’s beschikbaar: native xAI, OpenAI en de Vercel AI-SDK
- De API bestrijkt tekst, afbeeldingen, video, spraak en zoeken
- Twee niveaus van modellen: grok-4.7 (vlaggenschip, configureerbaar redeneren) en grok-4.3 (budget, 1M context)
- Bewaar uw API-sleutel altijd in een omgevingsvariabele, nooit hardgecodeerd