Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

API meghívása cURL-lal

8. lecke 14 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Az API-k tesztelésének univerzális eszköze
  2. Az első cURL kérésed
  3. A /v1/responses végpont használata
  4. Hasznos cURL kapcsolók
  5. A törzs olvasása fájlból
  6. Gyakori hibák hibakeresése
  7. Főbb megállapítások

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 -d flag 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_KEY parancscsal
  • 400 Bad Request: helytelenül formázott JSON. Érvényesítsd a JSON-t a jq . < request.json paranccsal
  • 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 jq eszkö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