Kald API'en med cURL
På denne side
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
jqtil at formatere og filtrere JSON-svar - Gem komplekse forespørgsler i separate JSON-filer