Management API: Upravljanje ključevima i naplatom
Na ovoj stranici
Upravljaj svojim računom bez konzole
xAI Management API je REST sučelje posvećeno upravljanju tvojim Enterprise računom. Dok Inference API (api.x.ai) poziva modele, Management API (management-api.x.ai) administrira tvoje resurse. Ta razlika može djelovati beznačajno. Nije. Sve što bi inače zahtijevalo da netko otvori web konzolu i klikne, ovdje postaje automatizirano – moguće pratiti, reproducirati i integrirati s alatima koje tvoji timovi već koriste.
Izdavanje i rotacija ključeva
Stvaranje ključeva putem API-ja omogućuje ti automatizaciju pripreme za novu aplikaciju ili okruženje:
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"
}'
Parametri u ovom zahtjevu u potpunosti definiraju opseg ključa:
- name: Identifikator ključa čitljiv ljudima
- acls: Popis dopuštenja (ovlašteni krajnje točke i modeli)
- qps/qpm/tpm: Ograničenja stope po sekundi, po minuti i tokena po minuti
- expireTime: Datum automatskog isteka
Postavljanje expireTime prilikom stvaranja navika je koja ti dugoročno štedi najviše problema: ključ izdan za tromjesečno pilotiranje sam istječe umjesto da beskonačno opstane u konfiguracijskoj datoteci koju više nitko ne čita.
Redovita rotacija ključeva slijedi istu higijenu sigurnosti. Namjenska krajnja točka generira novi tajni ključ i poništava stari:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Upozorenje: stari tajni ključ se poništava trenutačno i trajno. Pripremi se za uvođenje nove vrijednosti u svoj upravitelj tajnama prije pokretanja naredbe, nikada nakon toga. Tri krajnje točke samo za čitanje zaokružuju skup: GET /auth/teams/{teamId}/api-keys izlistava sve ključeve za tim, GET /auth/api-keys/{apiKeyId}/propagation provjerava je li ključ propagiran na sve čvorove, a GET /auth/teams/{teamId}/models izlistava dostupne modele s njihovim cijenama. Drugu provjeravaš odmah nakon rotacije, kada aplikacija i dalje vraća pogreške autentifikacije, a nisi siguran radi li se o grešci u aplikaciji ili jednostavno o kašnjenju propagacije.
Praćenje i kontrola naplate
Dohvaćanje informacija o naplati koristi namjensku krajnju točku:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Povijest računa dohvaćaš s filtriranjem po razdoblju, ovdje za ožujak 2026.:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Svaki račun ima status među PENDING, PAID, FAILED i WILL_NEVER_BE_CHARGED. Isticanje statusa FAILED u tvom nadzoru daleko je bolje nego da za incident saznaš putem prekida usluge u ponedjeljak ujutro.
Kako bi spriječio prekoračenje proračuna, konfiguriraj mjesečni limit:
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}'
Ako posluješ na osnovi prepaid modela, stanje provjeri na isti način:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Zapamti da su prepaid krediti nepovratni, osim ako to zakon ne zahtijeva. Veličinu svojih kupnji odredi na temelju potrošnje uočene tijekom nekoliko tjedana, a ne na temelju optimističnih projekcija rasta.
Nadziri svoju potrošnju na pravoj razini detaljnosti
Krajnja točka za analitiku omogućuje ti praćenje korištenja s finom granulacijom:
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"]
}
}'
Ovaj zahtjev vraća dnevnu potrošnju tokena, raščlanjenu po modelu, za ožujak. Promjenom timeUnit prelaziš s mjesečnog pregleda na pregled po minutama: moguće vrijednosti su MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR i MINUTE. Agregacije idu daleko iznad jednostavnih zbrojeva, uključujući SUM, AVG, MIN, MAX, P50, P90, P99 i COUNT. Percentili učinkovito karakteriziraju opterećenje jer prosjeci izglađuju upravo one skokove koji određuju kapacitet koji ti zapravo treba.
Management API tada zauzima svoje mjesto u tvom alatu. Ključeve pripremaš iz Terraforma ili Pulumija baš kao i bazu podataka, tvoj CI/CD pipeline stvara privremene ključeve za testna okruženja, a zatim ih briše na kraju izvršavanja, skripte za nadzor alertiraju prije dosezanja limita potrošnje, a tvoje interne nadzorne ploče prikazuju potrošnju bez da ljudi svakog ponedjeljka izvoze CSV datoteke.
Ključne točke
- Management API na management-api.x.ai upravlja ključevima, naplatom i metrikama
- Rotacija ključa trajno poništava stari tajni ključ
- Limiti potrošnje štite od prekoračenja proračuna
- Analitika korištenja nudi detaljnost od minute do mjeseca
- Integriraj Management API u svoje infrastrukturne alate kako bi automatizirao administraciju