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

AlapURL és az első kérés

1. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. A Management API: Egy külön vezérlősík
  2. AlapURL (Base URL)
  3. A Management API hitelesítése
  4. Végpontok szerkezete
  5. Az első management kérésed
  6. Főbb megállapítások

A Management API: Egy külön vezérlősík

Az xAI Management API-ja elkülönül attól a következtetési (inference) API-tól, amelyet a Grok-nak szóló promptok küldéséhez használsz. Ez lehetővé teszi az erőforrásaid adminisztrálását: API-kulcsok létrehozását és kezelését, a számlázás konfigurálását, a használat figyelését, valamint a csapatod hozzáférésének szabályozását. Mindez az adminisztráció egy dedikált URL-en keresztül történik.

AlapURL (Base URL)

Ez a szétválasztás nem csupán implementációs részlet: a két API közötti alapvető különbséget tükrözi. Az egyik tokeneket fogyaszt és modelleket futtat; a másik adminisztrál, számláz és engedélyeket ad. A két különböző domainen és kulcskészleten történő üzemeltetés garantálja, hogy egy ellopott alkalmazáskulcs soha nem képes további kulcsokat létrehozni vagy elolvasni a számlázási adataidat.

https://management-api.x.ai

Ne keverd össze ezt a https://api.x.ai címmel, amely a következtetési hívások (csevegés-kiegészítések, beágyazások stb.) URL-je. Minden management jellegű kérés – kulcsok, számlázás, analitika – a management-api.x.ai domaint használja.

2
Különálló URL-ek
REST
Szabványos architektúra
JSON
Adatcsere-formátum
Bearer
Hitelesítés

A Management API hitelesítése

A hitelesítési mechanizmus megegyezik – egy Bearer tokent kell küldeni az Authorization fejlécben –, de maga a kulcs nem ugyanaz. Ez a leggyakoribb hibaforrás a kezdésnél, amely egy teljesen átláthatatlan 401-es hibát eredményez: a hibaüzenet semmi jelet nem ad arra, hogy egyszerűen a megfelelő kulcsot a rossz API-nak mutattad be.

curl https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Ez az érvényesítési kérés (GET /auth/management-keys/validation) lehetővé teszi annak ellenőrzését, hogy a management kulcsod érvényes és aktív-e. Ez a legegyszerűbb belépési pont a konfigurációd teszteléséhez.

Management kulcs vs. Következtetési kulcs

  • Management kulcs: hozzáférést biztosít a management-api.x.ai végpontjaihoz (adminisztráció, számlázás, analitika)
  • Következtetési kulcs: hozzáférést biztosít az api.x.ai végpontjaihoz (csevegés, beágyazások, képek)

Mindkét kulcstípus az xAI konzolból generálható, de a hatáskörük eltérő. Egy következtetési kulcs nem fér hozzá a management végpontokhoz, és fordítva.

Végpontok szerkezete

A Management API végpontjai logikus felépítést követnek:

  • /auth/teams/{teamId}/api-keys — API-kulcsok kezelése
  • /auth/api-keys/{apiKeyId} — műveletek egy adott kulccsal
  • /auth/teams/{teamId}/models — elérhető modellek
  • /auth/teams/{teamId}/endpoints — elérhető ACL végpontok
  • /v1/billing/teams/{teamId}/ — számlázás és analitika

A teamId paraméter a csapatod azonosítója az xAI konzolban, és ez strukturálja szinte az összes végpontot. Minden csapatnak megvannak a saját kulcsai, kvótái és számlázási beállításai – ez teszi a természetes elszigetelési egységgé: két projekt két külön csapatba sorolása automatikusan elválasztja a költségkereteiket és a hozzáféréseiket is, minden további konfiguráció nélkül.

Az első management kérésed

Íme egy teljes példa a konfigurációd érvényesítésére:

# Define your management key
export MANAGEMENT_API_KEY="xai-mgmt-..."

# Validate the key
curl -s https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Ha a válasz tartalmazza a csapatodra és a kulcsodra vonatkozó információkat, akkor a konfigurációd működik. Ha 401-es hibát kapsz, ellenőrizd, hogy management kulcsot használsz-e (nem pedig következtetési kulcsot).

Főbb megállapítások

  • A Management API a https://management-api.x.ai címet használja, amely elkülönül a https://api.x.ai címtől
  • A hitelesítés egy Bearer tokent használ az Authorization fejlécben
  • A management kulcsok és a következtetési kulcsok hatásköre elkülönül
  • A GET /auth/management-keys/validation végpont lehetővé teszi a konfigurációd tesztelését
  • Minden management végpont a teamId köré épül fel