Omejitve porabe
Na tej strani
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
GETinPOSTna/v1/billing/teams/{teamId}/postpaid/spending-limitsza 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)