Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Volání API pomocí cURL

Lekce 8 z 14 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Univerzální nástroj pro testování API
  2. Tvůj první požadavek cURL
  3. Použití koncového bodu /v1/responses
  4. Užitečné přepínače cURL
  5. Čtení těla požadavku ze souboru
  6. Ladění běžných chyb
  7. Klíčové poznatky

Univerzální nástroj pro testování API

cURL je nástroj příkazového řádku dostupný na každém operačním systému. Umožňuje ti odesílat požadavky HTTP bez instalace SDK nebo psaní programu. Je to ideální nástroj pro rychlé testování koncového bodu, ladění požadavků nebo automatizaci volání v shell skriptu.

Tvůj první požadavek cURL

Takto odešleš požadavek na Grok API pomocí 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 příkazu

  • curl https://api.x.ai/v1/chat/completions: odešle požadavek POST (implicitně díky -d) na koncový bod
  • -H "Authorization: Bearer $XAI_API_KEY": přidá hlavičku pro ověření s tvým klíčem
  • -H "Content-Type: application/json": určuje, že tělo požadavku je ve formátu JSON
  • -d '{...}': tělo požadavku ve formátu JSON

Použití koncového bodu /v1/responses

Moderní koncový bod /v1/responses nabízí stručnější syntaxi:

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 u jednoduchých požadavků nahrazuje input pole messages. Místo pole zpráv můžeš předat přímo řetězec.

Užitečné přepínače cURL

Formátování výstupu JSON

Surová odpověď se špatně čte. Použij jq pro její formátování:

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 .

Přepínač -s (silent) skryje indikátor průběhu cURL.

Extrakce pouze odpovědi

Pokud chceš získat text odpovědi bez metadat:

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'

Zobrazení hlaviček odpovědi

Pro ladění limitů rychlosti nebo chyb přidej -i pro zobrazení hlaviček 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"}'

Čtení těla požadavku ze souboru

U složitých požadavků ulož JSON do souboru:

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

Poté na něj odkáž pomocí @:

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

Ladění běžných chyb

  • 401 Unauthorized: neplatný nebo chybějící klíč API. Zkontroluj pomocí echo $XAI_API_KEY
  • 400 Bad Request: chybně formátovaný JSON. Ověř svůj JSON příkazem jq . < request.json
  • 429 Too Many Requests: dosáhl jsi limitu rychlosti. Počkej několik sekund
  • 404 Not Found: zkontroluj URL a cestu ke koncovému bodu

Klíčové poznatky

  • cURL je ideální pro testování a ladění bez psaní kódu
  • Ověř se pomocí -H "Authorization: Bearer $XAI_API_KEY"
  • Použij jq pro formátování a filtrování odpovědí JSON
  • Složité požadavky ukládej do samostatných souborů JSON