Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Išlaidų limitai

Paskaita 7 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Valdyk savo API išlaidas
  2. Peržiūrėti dabartinius limitus
  3. Nustatyti limitus
  4. Peržiūrėti dabartinius mokesčius
  5. Automatizuoti išlaidų stebėjimą
  6. Dinamiškai koreguoti limitus
  7. Svarbiausi punktai

Valdyk savo API išlaidas

Išlaidų limitai yra tavo finansinis saugos tinklas. Jie nustato viršutinę ribą, kurios pasiekus API užklausos atmetamos, taip išvengiant netikėtų mokesčių mėnesio pabaigoje. Valdymo API (Management API) leidžia programiškai peržiūrėti ir nustatyti šiuos limitus.

Peržiūrėti dabartinius limitus

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Atsakyme matysi dabartinio ciklo viršutinę ribą ir savo dabartines išlaidas – taigi, apskaičiavęs skirtumą, sužinosi likusį biudžetą. Tai vienintelis skaičius, kuris rūpi kasdien: viršutinė riba be vartojimo duomenų nepasako, ar išnaudojai 10 %, ar jau 95 % savo biudžeto.

Nustatyti 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
  }'

Elgsena viršijus limitą

Štai raminanti dalis, kurią verta pabrėžti: pasiekus limitą niekada nebus priskaičiuota papildomų mokesčių. Užklausos atmetamos, o ne apmokestinamos viršijus ribą. Rizika perkeliama iš finansinės į prieinamumo sritį – būtent taip ir turi būti, nes sutrikimą galima diagnozuoti ir ištaisyti per kelias minutes, tuo tarpu netikėta sąskaita dažniausiai pastebima per vėlai.

Kai vartojimas pasiekia nustatytą limitą:

  • API užklausos atmetamos su specifiniu klaidos kodu
  • API raktai lieka aktyvūs, tačiau išvados (inference) užklausos nepavyksta
  • Limitas iš naujo nustatomas kito atsiskaitymo ciklo pradžioje

Limitų strategija pagal aplinką

Komandai, turinčiai kelis projektus, limitas turėtų atspindėti kiekvienai aplinkai būdingą riziką. Kūrimo (dev) aplinkoje tipinė grėsmė – atsitiktinis užklausų ciklas, pavyzdžiui, visą naktį veikiantis testavimo scenarijus; nedidelis 50–100 USD limitas tokią klaidą paverčia 10 USD incidentu, o ne 1 000 USD siurprizu. Testavimo (staging) aplinkoje vykdomi apkrovos testai, kurie teisėtai suvartoja daugiau: vidutinis 200–500 USD limitas palieka vietos testų kampanijoms, kartu išlaikant apsaugą. Tačiau gamybinė (production) aplinka niekada neturėtų būti ribojama taip, kad būtų atsisakoma aptarnauti klientų užklausas: didesnis limitas (1 000 USD ir daugiau, priklausomai nuo srauto) reikalauja aktyvaus stebėjimo – įspėjimas tave apsaugo, o limitas yra tik paskutinė išeitis.

Peržiūrėti dabartinius mokesčius

Norėdamas sužinoti savo būklę einamajame cikle:

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Šis galinis taškas grąžina sukauptus mokesčius nuo ciklo pradžios. Palyginus su praėjusių dienų skaičiumi, gauni ne tik momentinę nuotrauką, bet ir prognozę. Jei mėnesio trečdalyje išnaudota 40 % biudžeto – situacija normali; tas pats 40 % per mėnesio dešimtadalį signalizuoja apie viršijimą, ir tau dar lieka dvidešimt septynios dienos veikti.

Automatizuoti išlaidų stebėjimą

Slėnkstinio įspėjimo scenarijus

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Įspėti pasiekus 80 % limito

# Gauti 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)

# Gauti dabartines išlaidas
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)

# Patikrinti slenkstį
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}")
        # Siųsti pranešimą

Integracija su stebėjimo sistemomis

Sujunk mokesčių peržiūrą su savo stebėjimo sprendimu (Grafana, Datadog ir kt.), kad sukurtum realiuoju laiku veikiančias išlaidų skydelius:

# Gauti dabartinę sumą siuntimui į metrikų sistemą
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

Dinamiškai koreguoti limitus

Limitas nėra kartą ir visiems laikams nustatytas atsiskaitymo ciklui – ir tai gerai, nes produkto gyvavimo ciklas nesutampa su apskaitos kalendoriumi. Prieš numatomą srauto šuolį, produkto paleidimą ar rinkodaros kampaniją laikinai padidink limitą: nėra nieko blogiau nei mokama kampanija, siunčianti vartotojus į servisą, kurio API atmeta užklausas dėl pasiekto lubų. Atvirkščiai, jei mėnesio biudžetas išleidžiamas greičiau nei tikėtasi, limito sumažinimas likusiai ciklo daliai paverčia nuokrypį valdomu apribojimu. Kritiškiausias atvejis – išlaidų incidentas (ciklas gamybinėje aplinkoje, aptiktas piktnaudžiavimas): nedelsiant sumažintas limitas tampa tavo avariniu stabdžiu, kuris sustabdo „kraujavimą“, kol randama priežastis.

# Laikinai padidinti prieš paleidimą
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}'

# Atstatyti normalų limitą po šuolio
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}'

Svarbiausi punktai

  • Naudok GET ir POST metodus adresu /v1/billing/teams/{teamId}/postpaid/spending-limits, kad peržiūrėtum ir nustatytum limitus
  • Viršijus limitą, API užklausos atmetamos (jokių papildomų mokesčių)
  • Mokesčių peržiūra (invoice/preview) leidžia stebėti vartojimą realiuoju laiku
  • Automatizuok slėnkstinius įspėjimus, kad numatytum viršijimus
  • Pritaikyk limitus pagal aplinką (kūrimo, testavimo, gamybinė)