Anropa API:et med cURL
På denna sida
Det universella verktyget för att testa API:er
cURL är ett kommandoradsverktyg som finns tillgängligt på alla operativsystem. Det låter dig skicka HTTP-förfrågningar utan att installera ett SDK eller skriva ett program. Det är det perfekta verktyget för att snabbt testa en slutpunkt, felsöka en förfrågan eller automatisera anrop i ett skript.
Din första cURL-förfrågan
Så här skickar du en förfrågan till 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."}
]
}'
En genomgång av kommandot
curl https://api.x.ai/v1/chat/completions: skickar en POST-förfrågan (underförstått av-d) till slutpunkten-H "Authorization: Bearer $XAI_API_KEY": lägger till autentiseringshuvudet med din nyckel-H "Content-Type: application/json": anger att body:n är i JSON-format-d '{...}': förfrågningsbody:n i JSON-format
Använd slutpunkten /v1/responses
Den moderna slutpunkten /v1/responses erbjuder en mer koncis syntax:
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."
}'
Observera att input ersätter messages för enkla förfrågningar. Du kan skicka en sträng direkt istället för en array med meddelanden.
Användbara cURL-alternativ
Formatera JSON-utdata
Det råa svaret är svårt att läsa. Använd jq för att formatera 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 .
Alternativet -s (tyst) döljer cURL:s förloppsindikator.
Extrahera endast svaret
För att hämta själva svarstexten utan 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 svarsheadern
För att felsöka hastighetsbegränsningar eller fel, lägg till -i för att visa HTTP-headern:
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:n från en fil
För komplexa förfrågningar kan du lagra 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
}
Referera sedan till den med @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Felsök vanliga fel
- 401 Unauthorized: en ogiltig eller saknad API-nyckel. Kontrollera med
echo $XAI_API_KEY - 400 Bad Request: felaktigt formaterad JSON. Validera din JSON med
jq . < request.json - 429 Too Many Requests: du har nått hastighetsgränsen. Vänta några sekunder
- 404 Not Found: kontrollera URL:en och sökvägen till slutpunkten
Viktiga punkter
- cURL är perfekt för att testa och felsöka utan att skriva kod
- Autentisera med
-H "Authorization: Bearer $XAI_API_KEY" - Använd
jqför att formatera och filtrera JSON-svar - Lagra komplexa förfrågningar i separata JSON-filer