Kulupiirangud
Sellel lehel
API-kulude kontrollimine
Kulupiirangud on sinu finantsturvavõrk. Need määravad ülempiiri, mille ületamisel API-päringud tagasi lükatakse, hoides ära ootamatud kulud kuu lõpus. Haldus-API võimaldab neid piiranguid programmeeritult vaadata ja seada.
Praeguste piirangute vaatamine
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastus näitab jooksva tsükli ülempiiri ja sinu senist tarbimist – seega annab erinevus ülejäänud marginaali. See on ainus number, mis igapäevatöös loeb: ülempiir ilma tarbimisandmeteta ei ütle, kas oled oma eelarvest kasutanud 10% või 95%.
Piirangute seadmine
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
}'
Käitumine ülempiiri ületamisel
Siin on rahustav osa, mida tasub selgelt välja öelda: piirangu saavutamine ei põhjusta kunagi ülearvestamist. Päringud lükatakse tagasi, mitte ei arvelda neid ülempiirist kõrgemalt. Risk nihkub finantsiliselt kättesaadavusele – ja see on täpselt see, mida soovid, sest tööseisundi diagnoosimine ja lahendamine võtab minuteid, samas kui ootamatu arve avastatakse liiga hilja.
Kui tarbimine jõuab seatud piiranguni:
- API-päringud lükatakse tagasi konkreetse veakoodiga
- API-võtmed jäävad aktiivseks, kuid järelduspäringud (inference calls) ebaõnnestuvad
- Piirang lähtestatakse järgmise arveldustsükli alguses
Piirangu strateegia keskkonniti
Meeskonnal, millel on mitu projekti, peaks piirang peegeldama iga keskkonna spetsiifilist riski. Arenduses on tüüpiline oht juhuslik päringutsükkel – näiteks testiskript, mis töötab terve öö – ja madal piirang 50–100 dollarit muudab selle vea 10-dollariseks intsidentiks, mitte 1000-dollariseks üllatuseks. Testkeskkond (staging) tegeleb koormustestidega, mis tarbivad õigustatult rohkem: mõõdukas piirang 200–500 dollarit jätab ruumi testikampaaniatele, hoides samaliku kaitseraudtee. Tootmiskeskkonda aga ei tohi kunagi nii palju pidurdada, et kliendipäringuid tagasi lükataks: kõrgem piirang (1000 dollarit ja enam, sõltuvalt liiklusest) eeldab aktiivset jälgimist – hoiatus kaitseb sind, samas kui piirang on vaid viimase abinõuna toimiv turvavõrk.
Praeguste tasude vaatamine
Et näha, kus sa jooksvas tsüklis seisad:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
See lõpp-punkt tagastab tsükli algusest kogunenud tasud. Võrreldes möödunud päevade arvuga annab see rohkem kui hetktõmmise: prognoosi. Eelarvest 40% tarbimine kuu esimese kolmandiku jooksul on tervislik; sama 40% kuu esimese kümnendiku juures annab märku ületamisest ja sul on veel kakskümmend seitse päeva tegutsemiseks.
Kulude jälgimise automatiseerimine
Lävendihoiatuse skript
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Hoiatus 80% piirangust
# Piirangu hankimine
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)
# Praeguse tarbimise hankimine
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)
# Lävendi kontrollimine
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"HOIATUS: {ratio*100:.1f}% piirangust on saavutatud")
print(f" Kulu: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Teavituse saatmine
Integreerimine jälgimislahendustega
Ühenda tasude eelvaade oma jälgimislahendusega (Grafana, Datadog jms), et luua reaalajas kulude armatuurlauad:
# Praeguse summa hankimine ja saatmine oma mõõdikute süsteemi
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
Piirangute dünaamiline kohandamine
Piirang ei ole arveldustsükli jaoks kivisse raiutud – ja see on hea, sest toote elutsükkel ei järgi raamatupidamiskalendrit. Enne oodatavat liikluse tõusu, tootelansseerimist või turunduskampaaniat suurenda piirangut ajutiselt: midagi pole hullemat kui makstud kampaania, mis saadab kasutajad teenusele, mille API lükkab päringud tagasi saavutatud ülempiiri tõttu. Vastupidi, kui kuu eelarve on oodatust kiiremini kulutatud, muudab piirangu langetamine ülejäänud tsükli jaoks lahtivoolu kontrollitud piiranguks. Kriitilisemaks juhuks jääb kuluintsident – tsükkel tootmises, tuvastatud kuritarvitamine: piirangu viivitamatu langetamine on sinu hädaabipidur, mis peatab verejooksu, kuni leiad põhjuse.
# Ajutine suurendamine lansseerimiseks
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}'
# Normaalse piirangu taastamine pärast tõusu
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}'
Peamised punktid
- Kasuta
GETjaPOSTmeetodeid aadressil/v1/billing/teams/{teamId}/postpaid/spending-limitspiirangute vaatamiseks ja seadmiseks - Piirangu ületamisel API-päringud lükatakse tagasi (üle-arveldamine puudub)
- Tasude eelvaade (
invoice/preview) võimaldab tarbimist reaalajas jälgida - Automatiseeri lävendihoiatused, et ennustada ületamisi
- Kohanda piiranguid keskkonniti (arendus, test, tootmine)