Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kulupiirangud

Õppetund 7 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. API-kulude kontrollimine
  2. Praeguste piirangute vaatamine
  3. Piirangute seadmine
  4. Praeguste tasude vaatamine
  5. Kulude jälgimise automatiseerimine
  6. Piirangute dünaamiline kohandamine
  7. Peamised punktid

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 GET ja POST meetodeid aadressil /v1/billing/teams/{teamId}/postpaid/spending-limits piirangute 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)