API meghívása cURL-lal
Ezen az oldalon
Az API-k tesztelésének univerzális eszköze
A cURL egy parancssori eszköz, amely minden operációs rendszeren elérhető. Lehetővé teszi HTTP-kérések küldését SDK telepítése vagy program írása nélkül. Ideális választás végpontok gyors tesztelésére, kérések hibakeresésére vagy hívások automatizálására shell szkriptekben.
Az első cURL kérésed
Így küldhetsz kérést a Grok API felé cURL segítségével:
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."}
]
}'
A parancs részletes elemzése
curl https://api.x.ai/v1/chat/completions: POST kérést küld (a-dflag implikálja) a végpontra-H "Authorization: Bearer $XAI_API_KEY": hozzáadja a hitelesítési fejlécet a kulcsoddal-H "Content-Type: application/json": jelzi, hogy a törzs JSON formátumú-d '{...}': a kérés törzse JSON formátumban
A /v1/responses végpont használata
A modern /v1/responses végpont tömörebb szintaxist kínál:
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."
}'
Vedd észre, hogy az egyszerű kéréseknél az input mező váltja fel a messages tömböt. Közvetlenül adhatsz meg egy sztringet az üzenettömb helyett.
Hasznos cURL kapcsolók
A JSON kimenet formázása
A nyers válasz nehezen olvasható. Használd a jq eszközt a formázáshoz:
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 .
A -s (silent/csendes) kapcsoló elrejti a cURL folyamatjelző sávját.
Csak a válasz kinyerése
Ha csak a válasz szövegét szeretnéd lekérni a metaadatok nélkül:
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'
A válaszfejlécek megtekintése
A sebességkorlátozások vagy hibák hibakereséséhez add hozzá a -i kapcsolót a HTTP-fejlécek megjelenítéséhez:
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"}'
A törzs olvasása fájlból
Összetett kérések esetén érdemes a JSON-t fájlba menteni:
# 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
}
Ezután hivatkozz rá a @ jellel:
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d @request.json
Gyakori hibák hibakeresése
- 401 Unauthorized: érvénytelen vagy hiányzó API-kulcs. Ellenőrizd az
echo $XAI_API_KEYparancscsal - 400 Bad Request: helytelenül formázott JSON. Érvényesítsd a JSON-t a
jq . < request.jsonparanccsal - 429 Too Many Requests: elérted a sebességkorlátot. Várj néhány másodpercet
- 404 Not Found: ellenőrizd az URL-t és a végpont elérési útját
Főbb megállapítások
- A cURL tökéletes eszköz tesztelésre és hibakeresésre kódírás nélkül
- Hitelesítsd magad a
-H "Authorization: Bearer $XAI_API_KEY"kapcsolóval - Használd a
jqeszközt a JSON válaszok formázására és szűrésére - Tárold az összetett kéréseket külön JSON fájlokban