Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Kald API'en med cURL

Lektion 8 af 14 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Det universelle værktøj til test af API’er
  2. Din første cURL-forespørgsel
  3. Brug endpointet /v1/responses
  4. Nyttige cURL-indstillinger
  5. Læs body’en fra en fil
  6. Fejlfinding af almindelige fejl
  7. Vigtige pointer

Det universelle værktøj til test af API’er

cURL er et kommandolinjeværktøj, der findes på alle operativsystemer. Det lader dig sende HTTP-forespørgsler uden at skulle installere et SDK eller skrive et program. Det er det ideelle værktøj til hurtigt at teste et endpoint, fejlfinde en forespørgsel eller automatisere kald i et shell-script.

Din første cURL-forespørgsel

Sådan sender du en forespørgsel til Grok API med 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."}
    ]
  }'

Gennemgang af kommandoen

  • curl https://api.x.ai/v1/chat/completions: sender en POST-forespørgsel (underforstået via -d) til endpointet
  • -H "Authorization: Bearer $XAI_API_KEY": tilføjer godkendelsesheaderen med din nøgle
  • -H "Content-Type: application/json": angiver, at body’en er JSON
  • -d '{...}': forespørgslens body i JSON-format

Brug endpointet /v1/responses

Det moderne /v1/responses-endpoint tilbyder en mere koncis syntaks:

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

Bemærk, at input erstatter messages ved simple forespørgsler. Du kan sende en streng direkte i stedet for en array af beskeder.

Nyttige cURL-indstillinger

Formater JSON-outputtet

Det rå svar er svært at læse. Brug jq til at formatere det:

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 .

Indstillingen -s (silent) skjuler cURL’s fremdriftslinje.

Uddrag kun svaret

For at få selve svarsteksten uden metadata:

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'

Se svar-headers

For at fejlfinde rate limits eller fejl, skal du tilføje -i for at vise HTTP-headers:

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"}'

Læs body’en fra en fil

Ved komplekse forespørgsler kan du gemme JSON’en i en fil:

# 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
}

Referer derefter til den med @:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Fejlfinding af almindelige fejl

  • 401 Unauthorized: En ugyldig eller manglende API-nøgle. Tjek med echo $XAI_API_KEY
  • 400 Bad Request: Forkert formateret JSON. Valider din JSON med jq . < request.json
  • 429 Too Many Requests: Du har ramt rate limiten. Vent nogle få sekunder
  • 404 Not Found: Tjek URL’en og stien til endpointet

Vigtige pointer

  • cURL er perfekt til test og fejlfinding uden at skulle skrive kode
  • Godkend med -H "Authorization: Bearer $XAI_API_KEY"
  • Brug jq til at formatere og filtrere JSON-svar
  • Gem komplekse forespørgsler i separate JSON-filer