Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Klicanje API-ja s cURL

Lekcija 8 od 14 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Univerzalno orodje za testiranje API-jev
  2. Tvoja prva zahteva s cURL
  3. Uporaba končne točke /v1/responses
  4. Koristne možnosti cURL
  5. Branje telesa iz datoteke
  6. Odpravljanje pogostih napak
  7. Ključne ugotovitve

Univerzalno orodje za testiranje API-jev

cURL je orodje ukazne vrstice, na voljo na vsakem operacijskem sistemu. Omogoča ti pošiljanje zahtev HTTP brez namestitve SDK-ja ali pisanja programa. Je idealno orodje za hitro testiranje končne točke, odpravljanje napak v zahtevi ali avtomatizacijo klicev v lupinskem skriptu.

Tvoja prva zahteva s cURL

Tako pošlješ zahtevo API-ju Grok s 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."}
    ]
  }'

Razčlenitev ukaza

  • curl https://api.x.ai/v1/chat/completions: pošlje zahtevo POST (kar implicira -d) na končno točko
  • -H "Authorization: Bearer $XAI_API_KEY": doda glavo za avtentikacijo s tvojim ključem
  • -H "Content-Type: application/json": pove, da je telo v formatu JSON
  • -d '{...}': telo zahteve v formatu JSON

Uporaba končne točke /v1/responses

Sodobna končna točka /v1/responses ponuja jedrnatejšo sintakso:

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

Upoštevaj, da input nadomesti messages za preproste zahteve. Namesto polja sporočil lahko neposredno podaš niz.

Koristne možnosti cURL

Oblikovanje izhoda JSON

Surov odgovor je težko brati. Za oblikovanje uporabi jq:

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 .

Možnost -s (tiho) skrije vrstico napredka cURL.

Izvleči samo odgovor

Če želiš dobiti besedilo odgovora brez metapodatkov:

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'

Ogled glav odgovora

Za odpravljanje napak pri omejitvah hitrosti ali drugih napakah dodaj -i za prikaz glav HTTP:

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

Branje telesa iz datoteke

Za kompleksne zahteve shrani JSON v datoteko:

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

Nato se nanjo sklicuj z @:

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

Odpravljanje pogostih napak

  • 401 Unauthorized: neveljaven ali manjkajoč ključ API. Preveri z echo $XAI_API_KEY
  • 400 Bad Request: napačno oblikovan JSON. Preveri svoj JSON z jq . < request.json
  • 429 Too Many Requests: dosegel si omejitev hitrosti. Počakaj nekaj sekund
  • 404 Not Found: preveri URL in pot končne točke

Ključne ugotovitve

  • cURL je popoln za testiranje in odpravljanje napak brez pisanja kode
  • Avtenticiraj se z -H "Authorization: Bearer $XAI_API_KEY"
  • Uporabi jq za oblikovanje in filtriranje odgovorov JSON
  • Kompleksne zahteve shrani v ločene datoteke JSON