Pozivanje API-ja pomoću cURL-a
Na ovoj stranici
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
jqza formatiranje i filtriranje JSON odgovora - Pohrani složene zahtjeve u zasebne JSON datoteke