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

Omejitve porabe

Lekcija 7 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Nadzoruj stroške API-ja
  2. Preglej trenutne omejitve
  3. Nastavi omejitve
  4. Preglej trenutne obveznosti
  5. Avtomatiziraj nadzor stroškov
  6. Dinamično prilagajanje omejitev
  7. Ključne ugotovitve

Nadzoruj stroške API-ja

Omejitve porabe so tvoja finančna varnostna mreža. Določajo zgornjo mejo, po kateri se zahteve API zavrnejo, kar preprečuje nepričakovane obveznosti ob koncu meseca. Upravljalni API ti omogoča, da te omejitve programsko pregleduješ in nastavljaš.

Preglej trenutne omejitve

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Odgovor prikazuje trenutni strop cikla in tvojo trenutno porabo – tako lahko z odštevanjem dobiš preostali okvir. To je edina številka, ki je vsakodnevno pomembna: strop brez podatkov o porabi ti ne pove, ali si pri 10 % ali 95 % svojega proračuna.

Nastavi omejitve

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

Obnašanje ob preseženi omejitvi

Tukaj je pomirjujoči del in vredno ga je izrecno poudariti: dosega omejitve nikoli ne povzroči prekomernega obračuna. Zahteve so zavrnjene, ne pa zaračunane prek zgornje meje. Tveganje se premakne s finančnega na razpoložljivost – kar točno želiš, saj se izpad diagnosticira in odpravi v nekaj minutah, medtem ko nepričakovan račun odkriješ prepozno.

Ko poraba doseže nastavljeno omejitev:

  • Zahteve API so zavrnjene s posebno kodo napake
  • Ključi API ostanejo aktivni, vendar klici sklepanja (inference) odpovejo
  • Omejitev se ponastavi ob začetku naslednjega obračunskega cikla

Strategija omejevanja glede na okolje

Za ekipo z več projekti naj omejitev odraža tveganje, specifično za vsako okolje. V razvojnem okolju je tipična nevarnost nenamerna zanka zahtev – testna skripta, ki teče vso noč – in nizka omejitev med 50 $ in 100 $ to napako spremeni v incident v višini 10 $ namesto v presenečenje v višini 1.000 $. Staging okolje obravnava teste obremenitve, ki upravičeno porabijo več: zmerna omejitev med 200 $ in 500 $ pušča prostor za testne kampanje, hkrati pa ohranja varovalko. Produkcijsko okolje pa nikoli ne sme biti tako omejeno, da bi zavračalo zahteve strank: višja omejitev (1.000 $ in več, odvisno od prometa) pride z aktivnim nadzorom – opozorilo te ščiti, omejitev pa je le varnostna mreža za skrajni primer.

Preglej trenutne obveznosti

Če želiš videti, kje se nahajaš v trenutnem ciklu:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Ta končna točka vrne obveznosti, nabrane od začetka cikla. V primerjavi s številom preteklih dni ti daje več kot le posnetek stanja: daje ti projekcijo. Poraba 40 % proračuna v prvi tretjini meseca je zdrava; istih 40 % ob desetini meseca signalizira presežek, imaš pa še sedemindvajset dni za ukrepanje.

Avtomatiziraj nadzor stroškov

Skripta za opozorila ob dosegu praga

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Opozorilo pri 80 % omejitve

# Pridobi omejitev
limits_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/spending-limits",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
monthly_limit = limits_resp.json().get("monthlyLimit", 0)

# Pridobi trenutno porabo
preview_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/invoice/preview",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_spend = preview_resp.json().get("totalAmount", 0)

# Preveri prag
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"OPOZORILO: Doseženih {ratio*100:.1f} % omejitve")
        print(f"  Poraba: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Pošlji obvestilo

Integracija z nadzornimi sistemi

Kombiniraj predogled obveznosti s svojo nadzorno rešitvijo (Grafana, Datadog itd.) za ustvarjanje nadzornih plošč stroškov v realnem času:

# Pridobi trenutni znesek za pošiljanje v svoj sistem metrik
CURRENT_SPEND=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('totalAmount', 0))")

echo "xai.billing.current_spend:$CURRENT_SPEND|g" | nc -u -w1 localhost 8125

Dinamično prilagajanje omejitev

Omejitev ni vklesana v kamen za celoten obračunski cikel – in to je dobro, saj življenjski cikel izdelka ne sledi računovodskemu koledarju. Pred pričakovanim skokom prometa, zagonom izdelka ali marketinško kampanjo začasno povečaj omejitev: nič hujšega ni, kot da plačana kampanja pošilja uporabnike na storitev, katere API zavrača zahteve zaradi doseženega stropa. Nasprotno, če je mesečni proračun porabljen hitreje, kot je bilo pričakovano, znižanje omejitve za preostanek cikla spremeni drift v nadzorovano omejitev. Najbolj kritičen primer ostaja incident stroškov – zanka v produkciji, odkrita zloraba: takojšnje znižanje omejitve je tvoj gumb za nujni zaustav, tisti, ki ustavi krvavitev, medtem ko iščeš vzrok.

# Začasno povečaj za zagon
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 2000.00}'

# Po skoku ponastavi normalno omejitev
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 500.00}'

Ključne ugotovitve

  • Uporabi GET in POST na /v1/billing/teams/{teamId}/postpaid/spending-limits za pregled in nastavitev omejitev
  • Ko je omejitev presežena, so zahteve API zavrnjene (ni prekomernega obračuna)
  • Predogled obveznosti (invoice/preview) ti omogoča sledenje porabi v realnem času
  • Avtomatiziraj opozorila ob dosegu praga za predvidevanje presežkov
  • Prilagodi omejitve glede na okolje (razvoj, staging, produkcija)