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

Management API: Kulcs- és számlázáskezelés

12. lecke 14 közül Frissítve 2026. július 28. Középhaladó
Ezen az oldalon
  1. Fiókkezelés a konzol nélkül
  2. Kulcsok létrehozása és cseréje
  3. Számlázás nyomon követése és szabályozása
  4. Fogyasztás monitorozása a megfelelő szemcsézettséggel
  5. Főbb megállapítások

Fiókkezelés a konzol nélkül

A xAI Management API egy REST felület, amelyet kifejezetten a vállalati fiókjaid kezelésére terveztek. Míg az Inference API (api.x.ai) modelleket hív meg, addig a Management API (management-api.x.ai) az erőforrásaidat adminisztrálja. A különbség jelentéktelennek tűnhet. Nem az. Minden, ami egyébként megkövetelné, hogy valaki megnyissa a webes konzolt és kattintson, itt automatizálhatóvá válik – nyomon követhetően, reprodukálhatóan és integrálhatóan a csapataid által már használt eszközökkel.

Kulcsok létrehozása és cseréje

A kulcsok API-n keresztüli létrehozása lehetővé teszi az új alkalmazások vagy környezetek ellátásának automatizálását:

curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "cle-production-chatbot",
    "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
    "qps": 10,
    "qpm": 100,
    "tpm": 1000000,
    "expireTime": "2026-12-31T23:59:59Z"
  }'

A kérés paraméterei teljes mértékben meghatározzák a kulcs hatókörét:

  • name: Ember által olvasható azonosító a kulcshoz
  • acls: Engedélyek listája (engedélyezett végpontok és modellek)
  • qps/qpm/tpm: Sebességkorlátok másodpercenként, percenként és tokenenként percenként
  • expireTime: Automatikus lejárati dátum

Az expireTime beállítása már a létrehozáskor az a szokás, amely hosszú távon a legtöbb bajtól menti meg: egy három hónapos pilotra kiadott kulcs magától lejár, ahelyett, hogy végtelen ideig életben maradna egy olyan konfigurációs fájlban, amelyet már senki sem olvas.

A rendszeres kulcscsere ugyanazt a biztonsági higiéniát követi. A dedikált végpont új titkos kulcsot generál és érvényteleníti a régit:

curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Figyelem: a régi titkos kulcs azonnal és véglegesen érvénytelenné válik. Készülj fel az új érték titokkezelődben (secret manager) való telepítésére a parancs futtatása előtt, soha ne utána. Három csak olvasható végpont egészíti ki a készletet: a GET /auth/teams/{teamId}/api-keys listázza a csapat összes kulcsát, a GET /auth/api-keys/{apiKeyId}/propagation ellenőrzi, hogy a kulcs propagálódott-e az összes csomóponton, a GET /auth/teams/{teamId}/models pedig listázza az elérhető modelleket az áraikkal együtt. A másodikat akkor érdemes megvizsgálnod közvetlenül egy csere után, amikor egy alkalmazás még mindig hitelesítési hibákat ad vissza, és nem vagy biztos benne, hogy alkalmazáshibáról van-e szó, vagy csupán propagációs késleltetésről.

Számlázás nyomon követése és szabályozása

A számlázási információk lekérése egy dedikált végpontot használ:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

A számlatörténetet időszak szűréssel kérdezheted le, itt például 2026 márciusára:

curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Minden számla rendelkezik egy állapottal a következők közül: PENDING, PAID, FAILED és WILL_NEVER_BE_CHARGED. Egy FAILED állapot megjelenítése a monitoringodban sokkal jobb, mint ha hétfő reggel egy szolgáltatáskiesés révén értesülnél az incidensről.

A költségvetési túllépések megelőzése érdekében állíts be havi limitet:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 5000}'

Ha előrefizetett (prepaid) rendszerben működsz, ugyanígy ellenőrizheted az egyenleget:

# Egyenleg ellenőrzése
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

Ne feledd, hogy az előrefizetett kreditek nem téríthetők vissza, hacsak a jogszabályok másképp nem rendelkeznek. A vásárlásaid méretét a több hét alatt megfigyelt fogyasztás alapján határozd meg, ne optimista növekedési előrejelzések alapján.

Fogyasztás monitorozása a megfelelő szemcsézettséggel

Az analitikai végpont lehetővé teszi a használat finom szemcsézettségű nyomon követését:

curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-03-01 00:00:00",
        "endTime": "2026-04-01 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "DAY",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }'

Ez a kérés a márciusi napi tokenfogyasztást adja vissza, modell szerint lebontva. A timeUnit megváltoztatásával átválthatsz havi nézetről perces nézetre: a lehetséges értékek a MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR és MINUTE. Az aggregációk jóval túlmutatnak az egyszerű összegeken: elérhető a SUM, AVG, MIN, MAX, P50, P90, P99 és COUNT. A percentilisek hatékonyan jellemzik a terhelést, mert az átlagok kisimítják éppen azokat a csúcsokat, amelyek meghatározzák a ténylegesen szükséges kapacitást.

A Management API ezután elfoglalja helyét az eszközláncodban. A kulcsokat Terraformból vagy Pulmiból látod el, akárcsak egy adatbázist; a CI/CD pipeline-od ephemeral kulcsokat hoz létre teszt környezetekhez, majd a végrehajtás végén törli azokat; a monitorozó szkriptek riasztást küldenek, mielőtt elérnéd a költési limitet; belső dashboardjaid pedig emberi CSV-exportálás nélkül, minden hétfőn megjelenítik a fogyasztást.

Főbb megállapítások

  • A management-api.x.ai címen elérhető Management API kezeli a kulcsokat, a számlázást és a metrikákat
  • A kulcscsere véglegesen érvényteleníti a régi titkos kulcsot
  • A költési limitek megvédik a költségvetési túllépésektől
  • A használati analitika perctől hónapig terjedő szemcsézettséget kínál
  • Integráld a Management API-t az infrastruktúra-eszközeidbe az adminisztráció automatizálása érdekében