Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Management API: upravljanje ključev in obračunavanja

Lekcija 12 od 14 Posodobljeno 28. julij 2026 Srednje napredni
Na tej strani
  1. Upravljaj svoj račun brez konzole
  2. Dodeljevanje in rotacija ključev
  3. Spremljanje in nadzor obračunavanja
  4. Spremljajte svojo porabo na pravi ravni podrobnosti
  5. Ključne ugotovitve

Upravljaj svoj račun brez konzole

Management API xAI je vmesnik REST, namenjen upravljanju vašega računa za podjetja. Medtem ko Inference API (api.x.ai) klice modele, Management API (management-api.x.ai) upravlja vaša sredstva. Razlika se morda zdi majhna. Ni. Vse, kar bi sicer zahtevalo, da nekdo odpre spletno konzolo in klikne, postane tukaj avtomatizirano – sledljivo, ponovljivo in integrirano z orodji, ki jih vaša ekipa že uporablja.

Dodeljevanje in rotacija ključev

Ustvarjanje ključev prek API-ja vam omogoča avtomatizacijo dodeljevanja za novo aplikacijo ali okolje:

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 v tem zahtevku v celoti opredeljujejo obseg ključa:

  • name: Človeku berljiv identifikator za ključ
  • acls: Seznam dovoljenj (avtorizirane končne točke in modeli)
  • qps/qpm/tpm: Omejitve hitrosti na sekundo, na minuto in žetonov na minuto
  • expireTime: Datum samodejnega poteka veljavnosti

Nastavitev expireTime ob ustvarjanju je navada, ki vam dolgoročno prihrani največ težav: ključ, izdan za trimesečni pilotni projekt, samodejno poteče, namesto da bi neskončno ostal v konfiguracijski datoteki, ki je nihče več ne bere.

Redna rotacija ključev sledi isti varnostni higieni. Namenski končni točki generira nov tajni ključ in razveljavi starega:

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

Opozorilo: stari tajni ključ je razveljavljen takoj in trajno. Pred zagonom ukaza pripravite namestitev nove vrednosti v svoj upravitelj skrivnosti, nikoli šele afterward. Tri končne točke samo za branje dopolnjujejo nabor: GET /auth/teams/{teamId}/api-keys izpiše vse ključe za ekipo, GET /auth/api-keys/{apiKeyId}/propagation preveri, ali je ključ razširjen na vsa vozlišča, in GET /auth/teams/{teamId}/models izpiše dostopne modele z njihovimi cenami. Drugo je tista, ki jo preverite takoj po rotaciji, ko aplikacija še vedno vrača napake pri avtentikaciji in niste prepričani, ali gre za hrošča v aplikaciji ali preprosto za zamudo pri razširjanju.

Spremljanje in nadzor obračunavanja

Pridobivanje informacij o obračunu uporablja namensko končno točko:

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

Zgodovino računov pridobite s filtriranjem po obdobju, tukaj za marec 2026:

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

Vsak račun ima status med PENDING, PAID, FAILED in WILL_NEVER_BE_CHARGED. Razkritje statusa FAILED v vašem nadzoru je veliko bolje, kot da za incident izveste prek prekinitve storitve v ponedeljek zjutraj.

Za preprečevanje presežkov proračuna konfigurirajte mesečno omejitev:

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}'

Če poslujetepredplačniško, stanje preverite na enak način:

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

Ne pozabite, da predplačniški krediti niso vračljivi, razen če to zahteva zakon. Velikost nakupov prilagodite porabi, opaženi v več tednih, ne optimističnim napovedim rasti.

Spremljajte svojo porabo na pravi ravni podrobnosti

Končna točka za analitiko vam omogoča sledenje uporabi z visoko ločljivostjo:

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"]
    }
  }'

Ta zahtevek vrne dnevno porabo žetonov, razčlenjeno po modelu, za marec. S spremembo timeUnit preklopite iz mesečnega pogleda na pogled na minuto: možne vrednosti so MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR in MINUTE. Agregacije segajo dlje od preprostih vsot, vključujejo SUM, AVG, MIN, MAX, P50, P90, P99 in COUNT. Percentili učinkovito označujejo obremenitev, saj povprečja zgladijo prav tiste vrhove, ki določajo zmogljivost, ki jo dejansko potrebujete.

Management API nato zavzame svoje mesto v vašem orodjarniku. Ključe dodeljujete iz Terraform ali Pulumi tako kot bazo podatkov, vaša cevovod CI/CD ustvari efemerne ključe za testna okolja in jih na koncu izvajanja izbriše, skripte za nadzor opozorijo, preden je dosežena omejitev porabe, vaši interni nadzorni plošči pa prikazujejo porabo, ne da bi človek vsak ponedeljek izvažal CSV.

Ključne ugotovitve

  • Management API na management-api.x.ai upravlja ključe, obračunavanje in metrike
  • Rotacija ključa trajno razveljavi stari tajni ključ
  • Omejitve porabe ščitijo pred presežki proračuna
  • Analitika uporabe ponuja podrobnost od minute do meseca
  • Integrirajte Management API v svoja infrastrukturna orodja za avtomatizacijo upravljanja