Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Pozivanje API-ja pomoću cURL-a

Lekcija 8 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Univerzalni alat za testiranje API-ja
  2. Tvoj prvi cURL zahtjev
  3. Korištenje krajnje točke /v1/responses
  4. Korisne opcije cURL-a
  5. Čitanje tijela iz datoteke
  6. Otklanjanje čestih grešaka
  7. Ključne točke

Univerzalni alat za testiranje API-ja

cURL je alat naredbenog retka dostupan na svakom operacijskom sustavu. Omogućuje ti slanje HTTP zahtjeva bez instaliranja SDK-a ili pisanja programa. Idealno je rješenje za brzo testiranje krajnje točke, otklanjanje grešaka u zahtjevu ili automatizaciju poziva u shell skripti.

Tvoj prvi cURL zahtjev

Evo kako poslati zahtjev Grok API-ju pomoću cURL-a:

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

Raščlanjivanje naredbe

  • curl https://api.x.ai/v1/chat/completions: šalje POST zahtjev (podrazumijevano s -d) na krajnju točku
  • -H "Authorization: Bearer $XAI_API_KEY": dodaje zaglavlje za autentifikaciju s tvojim ključem
  • -H "Content-Type: application/json": označava da je tijelo u JSON formatu
  • -d '{...}': tijelo zahtjeva u JSON formatu

Korištenje krajnje točke /v1/responses

Moderna krajnja točka /v1/responses nudi sažetiju sintaksu:

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

Imaj na umu da input zamjenjuje messages za jednostavne zahtjeve. Možeš proslijediti niz znakova izravno umjesto polja poruka.

Korisne opcije cURL-a

Formatiranje JSON izlaza

Sirovi odgovor teško je čitati. Upotrijebi jq za njegovo formatiranje:

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 .

Opcija -s (silent) skriva cURL-ovu traku napretka.

Izdvajanje samo odgovora

Da bi dobio/la tekst odgovora bez metapodataka:

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'

Pregled zaglavlja odgovora

Za otklanjanje grešaka vezanih uz ograničenja brzine (rate limits) ili druge pogreške, dodaj -i za prikaz HTTP zaglavlja:

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

Čitanje tijela iz datoteke

Za složene zahtjeve pohrani JSON u datoteku:

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

Zatim je referenciraj pomoću @:

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

Otklanjanje čestih grešaka

  • 401 Unauthorized: nevažeći ili nedostajući API ključ. Provjeri s echo $XAI_API_KEY
  • 400 Bad Request: neispravan JSON. Validiraj svoj JSON s jq . < request.json
  • 429 Too Many Requests: premašio/la si ograničenje brzine. Pričekaj nekoliko sekundi
  • 404 Not Found: provjeri URL i putanju krajnje točke

Ključne točke

  • cURL je savršen za testiranje i otklanjanje grešaka bez pisanja koda
  • Autentificiraj se s -H "Authorization: Bearer $XAI_API_KEY"
  • Upotrijebi jq za formatiranje i filtriranje JSON odgovora
  • Pohrani složene zahtjeve u zasebne JSON datoteke