Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Volanie API pomocou cURL

Lekcia 8 z 14 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Univerzálny nástroj na testovanie API
  2. Tvoja prvá požiadavka cURL
  3. Použitie koncového bodu /v1/responses
  4. Užitočné možnosti cURL
  5. Čítanie tela požiadavky zo súboru
  6. Ladenie bežných chýb
  7. Kľúčové poznatky

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