Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Limiti tan-Nefqa

Lezzjoni 7 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Ikkontrolla l-Ispejjeż tal-API tiegħek
  2. Ara l-Limiti Attwali
  3. Stabbilixxi l-Limiti
  4. Ara l-Ħlasijiet Attwali
  5. Awtomatizza l-Monitoraġġ tal-Ispejjeż
  6. Aġġusta l-Limiti Dinamikament
  7. Punti Ewlenin

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 GET u POST fuq /v1/billing/teams/{teamId}/postpaid/spending-limits biex 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)