Volání API pomocí cURL
Na této stránce
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
jqpro formátování a filtrování odpovědí JSON - Složité požadavky ukládej do samostatných souborů JSON