Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Līdzekļu izlietojuma limiti

Nodarbība 7 no 14 Atjaunota 2026. gada 29. jūlijs Programmētājs
Šajā lapā
  1. Kontrolē savas API izmaksas
  2. Apskati pašreizējos limitus
  3. Iestati limitus
  4. Apskati pašreizējos maksājumus
  5. Automatē izmaksu uzraudzību
  6. Dinamiski pielāgo limitus
  7. Galvenās atziņas

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 GET un POST pie /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)