AlapURL és az első kérés
Ezen az oldalon
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.
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.aivégpontjaihoz (adminisztráció, számlázás, analitika) - Következtetési kulcs: hozzáférést biztosít az
api.x.aivé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.aicímet használja, amely elkülönül ahttps://api.x.aicímtől - A hitelesítés egy Bearer tokent használ az
Authorizationfejlécben - A management kulcsok és a következtetési kulcsok hatásköre elkülönül
- A
GET /auth/management-keys/validationvégpont lehetővé teszi a konfigurációd tesztelését - Minden management végpont a
teamIdköré épül fel