Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De API aanroepen met cURL

Les 8 van 14 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Het universele hulpmiddel voor het testen van API’s
  2. Uw eerste cURL-verzoek
  3. Gebruik het /v1/responses-endpoint
  4. Handige cURL-opties
  5. De body vanuit een bestand lezen
  6. Veelvoorkomende fouten debuggen
  7. Belangrijkste punten

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 jq om JSON-responsen op te maken en te filteren
  • Sla complexe verzoeken op in aparte JSON-bestanden