Volanie API pomocou cURL
Na tejto strane
Univerzálny nástroj na testovanie API
cURL je nástroj príkazového riadku dostupný na každom operačnom systéme. Umožňuje ti odosielať požiadavky HTTP bez inštalácie SDK alebo písania programu. Je ideálnym nástrojom na rýchle testovanie koncového bodu, ladenie požiadaviek alebo automatizáciu volaní v shell skripte.
Tvoja prvá požiadavka cURL
Takto odošleš požiadavku na Grok API pomocou 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."}
]
}'
Rozbor príkazu
curl https://api.x.ai/v1/chat/completions: odosiela požiadavku POST (implicitne určenú parametrom-d) na koncový bod-H "Authorization: Bearer $XAI_API_KEY": pridáva hlavičku overenia s tvojím kľúčom-H "Content-Type: application/json": určuje, že telo požiadavky je vo formáte JSON-d '{...}': telo požiadavky vo formáte JSON
Použitie koncového bodu /v1/responses
Moderný koncový bod /v1/responses ponúka stručnejšiu 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."
}'
Všimni si, že pri jednoduchých požiadavkách nahrádza parameter input parameter messages. Namiesto poľa správ môžeš priamo odovzdať reťazec.
Užitočné možnosti cURL
Formátovanie výstupu JSON
Surová odpoveď sa ťažko číta. Na jej formátovanie použi nástroj 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žnosť -s (tichý režim) skryje indikátor priebehu cURL.
Extrahovanie iba odpovede
Ak chceš získať text odpovede bez metadát:
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'
Zobrazenie hlavičiek odpovede
Pri ladení limitov rýchlosti alebo chýb pridaj parameter -i, ktorý zobrazí hlavičky 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"}'
Čítanie tela požiadavky zo súboru
Pri zložitých požiadavkách ulož JSON do súboru:
# 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
}
Následne naň odkáž pomocou @:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Ladenie bežných chýb
- 401 Unauthorized: neplatný alebo chýbajúci kľúč API. Skontroluj príkazom
echo $XAI_API_KEY - 400 Bad Request: chybný formát JSON. Over svoj JSON príkazom
jq . < request.json - 429 Too Many Requests: dosiahol si limit rýchlosti. Počkaj niekoľko sekúnd
- 404 Not Found: skontroluj URL a cestu ku koncovému bodu
Kľúčové poznatky
- cURL je ideálny na testovanie a ladenie bez potreby písania kódu
- Overenie vykonáš pomocou
-H "Authorization: Bearer $XAI_API_KEY" - Na formátovanie a filtrovanie odpovedí JSON použi nástroj
jq - Zložité požiadavky ukladaj do samostatných súborov JSON