Išlaidų limitai
Šiame puslapyje
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
GETirPOSTmetodus 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ė)