De API aanroepen met cURL
Op deze pagina
Het universele hulpmiddel voor het testen van API’s
cURL is een command-line tool die op elk besturingssysteem beschikbaar is. Hiermee kunt u HTTP-verzoeken verzenden zonder een SDK te installeren of een programma te schrijven. Het is het ideale hulpmiddel om snel een endpoint te testen, een verzoek te debuggen of oproepen te automatiseren in een shell-script.
Uw eerste cURL-verzoek
Zo verzendt u een verzoek naar de Grok API met cURL:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"messages": [
{"role": "user", "content": "Hello, introduce yourself in one sentence."}
]
}'
De opdracht ontleden
curl https://api.x.ai/v1/chat/completions: verzendt een POST-verzoek (impliciet door-d) naar het endpoint-H "Authorization: Bearer $XAI_API_KEY": voegt de authenticatieheader toe met uw sleutel-H "Content-Type: application/json": geeft aan dat de body JSON is-d '{...}': de verzoek-body in JSON-indeling
Gebruik het /v1/responses-endpoint
Het moderne /v1/responses-endpoint biedt een beknoptere syntaxis:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"input": "Explain machine learning to me in simple terms."
}'
Merk op dat input de plaats inneemt van messages voor eenvoudige verzoeken. U kunt direct een string doorgeven in plaats van een array met berichten.
Handige cURL-opties
De JSON-uitvoer opmaken
De ruwe respons is moeilijk leesbaar. Gebruik jq om deze op te maken:
curl -s https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Hello"}' | jq .
De optie -s (silent) verbergt de voortgangsbalk van cURL.
Alleen het antwoord extraheren
Om de tekst van het antwoord zonder metadata op te halen:
curl -s https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.5",
"messages": [{"role": "user", "content": "Hello"}]
}' | jq -r '.choices[0].message.content'
De responsheaders bekijken
Om rate limits of fouten te debuggen, voegt u -i toe om de HTTP-headers weer te geven:
curl -i https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Test"}'
De body vanuit een bestand lezen
Voor complexe verzoeken slaat u de JSON op in een bestand:
# request.json
{
"model": "grok-4.5",
"messages": [
{"role": "system", "content": "You are a translator."},
{"role": "user", "content": "Translate into French: Hello world"}
],
"temperature": 0.3
}
Verwijs er vervolgens naar met @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Veelvoorkomende fouten debuggen
- 401 Unauthorized: een ongeldige of ontbrekende API-sleutel. Controleer met
echo $XAI_API_KEY - 400 Bad Request: verkeerd opgemaakte JSON. Valideer uw JSON met
jq . < request.json - 429 Too Many Requests: u heeft de rate limit bereikt. Wacht een paar seconden
- 404 Not Found: controleer de URL en het endpoint-pad
Belangrijkste punten
- cURL is perfect voor het testen en debuggen zonder code te schrijven
- Authenticeer met
-H "Authorization: Bearer $XAI_API_KEY" - Gebruik
jqom JSON-responsen op te maken en te filteren - Sla complexe verzoeken op in aparte JSON-bestanden