Management API: Kulcs- és számlázáskezelés
Ezen az oldalon
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