Līdzekļu izlietojuma limiti
Šajā lapā
Kontrolē savas API izmaksas
Līdzekļu izlietojuma limiti ir tavs finanšu drošības tīkls. Tie nosaka griestus, pārsniedzot kuriem API pieprasījumi tiek noraidīti, tādējādi novēršot negaidītus rēķinus mēneša beigās. Pārvaldības API ļauj tev šos limitus programmētiski apskatīt un iestatīt.
Apskati pašreizējos limitus
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Atbilde parāda pašreizējā cikla griestus un tavu faktisko patēriņu – tātad, aprēķinot starpību, arī atlikušo rezervi. Tas ir vienīgais skaitlis, kam ikdienā ir nozīme: griesti bez patēriņa datiem nepasaka, vai esi izlietojis 10% vai 95% no budžeta.
Iestati limitus
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
}'
Uzvedība, kad limits ir pārsniegts
Šeit ir labā ziņa, un to ir vērts pateikt skaidri: limita sasniegšana nekad neizraisa pārmaksu. Pieprasījumi tiek noraidīti, nevis apmaksāti virs noteiktā griesta. Risks pāriet no finanšu uz pieejamības jomu – un tieši tā tam arī jābūt, jo pārtraukumu var diagnosticēt un novērst minūšu laikā, savukārt negaidīts rēķins bieži tiek atklāts par vēlu.
Kad patēriņš sasniedz noteikto limitu:
- API pieprasījumi tiek noraidīti ar konkrētu kļūdas kodu
- API atslēgas paliek aktīvas, bet secinājumu (inference) izsaukumi neizdodas
- Limits tiek atiestatīts nākamā rēķinu cikla sākumā
Limitu stratēģija atkarībā no vides
Komandai ar vairākiem projektiem limitam jāatbilst katras vides specifiskajiem riskiem. Izstrādes vidē tipisks drauds ir nejaušs pieprasījumu cikls – testa skripts, kas darbojas visu nakti – un zems limits no 50 līdz 100 USD pārvērš šo kļūdu 10 USD incidentā, nevis 1000 USD pārsteigumā. Testēšanas (staging) vide apstrādā slodzes testus, kas likumīgi patērē vairāk: mērens limits no 200 līdz 500 USD dod vietu testu kampaņām, vienlaikus saglabājot drošības barjeru. Ražošanas videi (production) savukārt nekad nevajadzētu tik ierobežotai, ka tā noraida klientu pieprasījumus: augstāks limits (1000 USD un vairāk, atkarībā no tavas satiksmes) prasa aktīvu uzraudzību – brīdinājums tevi pasargā, bet limits ir tikai pēdējās instances drošības tīkls.
Apskati pašreizējos maksājumus
Lai redzētu, kur atrodies pašreizējā ciklā:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Šis galapunkts atgriež kopējos maksājumus, kas uzkrāti kopš cikla sākuma. Salīdzinot to ar pagājušo dienu skaitu, tas dod vairāk nekā tikai momentuzņēmumu: tas ir prognozes rīks. Ja mēneša trešdaļā ir izlietoti 40% no budžeta, tas ir veselīgi; tie paši 40% mēneša desmitajā daļā signalizē par pārtēriņu, un tev vēl ir divdesmit septiņas dienas, lai rīkotos.
Automatē izmaksu uzraudzību
Sliekšņa brīdinājuma skripts
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Brīdinājums pie 80% no limita
# Iegūst limitu
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)
# Iegūst pašreizējo patēriņu
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)
# Pārbauda slieksni
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"BRĪDINĀJUMS: Sasniegti {ratio*100:.1f}% no limita")
print(f" Izdevumi: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Nosūti paziņojumu
Integrācija ar uzraudzības sistēmām
Apvieno rēķina priekšskatījumu ar savu uzraudzības risinājumu (Grafana, Datadog u.c.), lai izveidotu reāllaika izmaksu informācijas paneļus:
# Iegūst pašreizējo summu, lai nosūtītu uz savu metrikas sistēmu
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
Dinamiski pielāgo limitus
Limits nav akmenī iekalts visam rēķinu ciklam – un tas ir labi, jo produktu dzīves cikls neseko grāmatvedības kalendāram. Pirms gaidāmā satiksmes pieauguma, produkta laišanas klajā vai mārketinga kampaņas, pagaidām palielini limitu: nav nekas sliktāks par apmaksātu kampaņu, kas novirza lietotājus uz servisu, kura API noraida pieprasījumus sasniegto griestu dēļ. Turpretī, ja mēneša budžets tiek iztērēts ātrāk nekā plānots, limita samazināšana atlikušajam cikla periodam pārvērš novirzi kontrolētā ierobežojumā. Viskritiskākais gadījums joprojām ir izmaksu incidents – cikls ražošanas vidē, konstatēta ļaunprātīga izmantošana: limita tūlītēja samazināšana ir tavs ārkārtas apstādināšanas pogas aizstājējs, kas aptur zaudējumus, kamēr atrodi cēloni.
# Pagaidām palielini limitu palaišanai
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}'
# Atiestati normālo limitu pēc pieauguma
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}'
Galvenās atziņas
- Izmanto
GETunPOSTpie/v1/billing/teams/{teamId}/postpaid/spending-limits, lai apskatītu un iestatītu limitus - Kad limits ir pārsniegts, API pieprasījumi tiek noraidīti (nav pārmaksas)
- Rēķina priekšskatījums (
invoice/preview) ļauj reāllaikā sekot līdzi patēriņam - Automatē sliekšņa brīdinājumus, lai laicīgi prognozētu pārtēriņu
- Pielāgo limitus atkarībā no vides (izstrāde, testēšana, ražošana)