Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Management API: Upravljanje ključevima i naplatom

Lekcija 12 od 14 Ažurirano 28. srpnja 2026. Srednja razina
Na ovoj stranici
  1. Upravljaj svojim računom bez konzole
  2. Izdavanje i rotacija ključeva
  3. Praćenje i kontrola naplate
  4. Nadziri svoju potrošnju na pravoj razini detaljnosti
  5. Ključne točke

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