Limiti tan-Nefqa
F'din il-paġna
Ikkontrolla l-Ispejjeż tal-API tiegħek
Il-limiti tan-nefqa huma x-xibka ta’ sigurtà finanzjarja tiegħek. Dawn jistabbilixxu saqaf li lil hinn minnu t-talbiet tal-API jiġu miċħuda, u b’hekk jipprevjenu tariffi mhux mistennija fi tmiem ix-xahar. L-API tal-Ġestjoni (Management API) tippermettilek tara u tistabbilixxi dawn il-limiti b’mod programmatiku.
Ara l-Limiti Attwali
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ir-rispons juri s-saqaf taċ-ċiklu attwali u l-konsum attwali tiegħek—għalhekk, bid-differenza, il-marġni li fadal. Dan huwa l-uniku numru li jimpurtak kuljum: saqaf mingħajr data dwar il-konsum ma jgħidlekx jekk intiex f’10% jew 95% tal-baġit tiegħek.
Stabbilixxi l-Limiti
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
}'
Imġiba Meta Jinqabeż il-Limitu
Hawnhekk hemm il-parti li tikkalma, u tisħoq li tingħad b’mod espliċitu: il-wasla għal-limiti qatt ma tirriżulta f’fatturazzjoni żejda. It-talbiet jiġu miċħuda, mhux iffatturati lil hinn mis-saqaf. Ir-riskju jiċċaqlaq minn dak finanzjarju għal dak tad-disponibbiltà—li huwa eżattament dak li trid, għax ħsara (outage) tiġi djanjostikata u ssolvuta fi ftit minuti, filwaqt li fattura mhux mistennija tiġi skoperta tard wisq.
Meta l-konsum jilħaq il-limitu stabbilit:
- It-talbiet tal-API jiġu miċħuda b’kodiċi ta’ żball speċifiku
- Iċ-ċwievet tal-API jibqgħu attivi iżda s-sejħiet tal-inferenza jfallu
- Il-limitu jiġi rrisettjat fil-bidu taċ-ċiklu ta’ fatturazzjoni li jmiss
Strateġija tal-Limiti skont l-Ambjent
Għal tim b’ħafna proġetti, il-limitu għandu jirrifletti r-riskju speċifiku għal kull ambjent. Fl-iżvilupp, il-periklu tipiku huwa ċ-ċirkolu aċċidentali ta’ talbiet—skript ta’ test li jgħaddi l-lejl kollu—u limitu baxx ta’ $50 sa $100 jibdel dak l-iżball f’inċident ta’ $10 minflok sorpriża ta’ $1,000. L-ambjent ta’ Staging jittratta testijiet ta’ tagħbija, li legitimate jikkunsmaw aktar: limitu moderat ta’ $200 sa $500 iħalli spazju għal kampanji ta’ test filwaqt li jżomm gardrail. Il-Produzzjoni, madankollu, qatt m’għandha tiġi mrażżna sal-punt li tiċħad it-talbiet tal-klijenti: limitu ogħla ($1,000 u lil hinn, skont it-traffiku tiegħek) jiġi b’monitoraġġ attiv—l-allerta tipproteġik, filwaqt li l-limitu huwa biss ix-xibka ta’ sigurtà tal-aħħar riżors.
Ara l-Ħlasijiet Attwali
Biex tara fejn qiegħed fiċ-ċiklu attwali:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dan l-endpoint jirritorna l-ħlasijiet akkumulati mill-bidu taċ-ċiklu. Meta mqabbel man-numru ta’ ġranet li għaddew, jagħtik aktar minn sempliċi stampa: jagħtik projezzjoni. Li tikkonsma 40% tal-baġit f’terz tax-xahar huwa f’saħħtu; l-istess 40% f’għaxar tax-xahar jissinjala superament, u għadek fadal sebgħa u għoxrin jum biex taġixxi.
Awtomatizza l-Monitoraġġ tal-Ispejjeż
Skript ta’ Allerta ta’ Soglia
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Alert at 80% of limit
# Get the limit
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)
# Get current consumption
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)
# Check threshold
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERT: {ratio*100:.1f}% of limit reached")
print(f" Spend: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Send notification
Integrazzjoni mal-Monitoraġġ
Għaqqad il-previżjoni tal-ħlasijiet mas-soluzzjoni ta’ monitoraġġ tiegħek (Grafana, Datadog, eċċ.) biex toħloq dashboards tal-ispejjeż f’ħin reali:
# Get current amount to send to your metrics system
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
Aġġusta l-Limiti Dinamikament
Il-limitu mhuwiex imnaqqax fil-ġebel għaċ-ċiklu ta’ fatturazzjoni—u dik hija ħaġa tajba, għax il-ħajja tal-prodott ma ssegwix il-kalendarju tal-kontabbiltà. Qabel żieda mistennija fit-traffiku, tnedija ta’ prodott, jew kampanja ta’ marketing, żid temporanjament il-limitu: xejn mhu agħar minn kampanja mħallsa li tibgħat lill-utenti lejn servizz li l-API tiegħu tiċħad it-talbiet minħabba saqaf milħuq. Bil-maqlub, jekk il-baġit tax-xahar diġà ntefaq aktar malajr milli mistenni, it-tnaqqis tal-limitu għall-bqija taċ-ċiklu jbiddel id-devjazzjoni f’vincolo kkontrollat. L-aktar każ kritiku jibqa’ inċident ta’ spiża—ċirkolu fil-produzzjoni, abbuż skopert: it-tnaqqis tal-limitu immedjatament huwa l-buttuna ta’ emerġenza tiegħek, dik li twaqqaf it-telf filwaqt li ssib il-kawża.
# Temporarily increase for a launch
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}'
# Reset normal limit after the spike
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}'
Punti Ewlenin
- Uża
GETuPOSTfuq/v1/billing/teams/{teamId}/postpaid/spending-limitsbiex tara u tistabbilixxi l-limiti - Meta jinqabeż il-limitu, it-talbiet tal-API jiġu miċħuda (l-ebda fatturazzjoni żejda)
- Il-previżjoni tal-ħlasijiet (
invoice/preview) tippermettilek issegwi l-konsum f’ħin reali - Awtomatizza l-allerti tas-soglia biex tbassar is-superamenti
- Adatta l-limiti skont l-ambjent (dev, staging, production)