Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Anropa API:et med cURL

Lektion 8 av 14 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. Det universella verktyget för att testa API:er
  2. Din första cURL-förfrågan
  3. Använd slutpunkten /v1/responses
  4. Användbara cURL-alternativ
  5. Läs body:n från en fil
  6. Felsök vanliga fel
  7. Viktiga punkter

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 jq för att formatera och filtrera JSON-svar
  • Lagra komplexa förfrågningar i separata JSON-filer