Limity míňania
Na tejto strane
Kontrola nákladov na API
Limity míňania sú tvoja finančná poistka. Nastavujú strop, po ktorom prekročení sú požiadavky na API odmietnuté, čím sa predchádza neočakávaným poplatkom na konci mesiaca. Management API ti umožňuje tieto limity programovo zobrazovať a nastavovať.
Zobrazenie aktuálnych limitov
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpoveď zobrazuje aktuálny strop cyklu a tvoju aktuálnu spotrebu – takže rozdielom získaš zostávajúcu rezervu. Toto je jediné číslo, ktoré sa denne počíta: strop bez údajov o spotrebe ti nepovie, či si na 10 % alebo 95 % svojho rozpočtu.
Nastavenie limitov
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
}'
Správanie po prekročení
Tu je tá upokojujúca časť a stojí za to ju vysloviť explicitne: dosiahnutie limitu nikdy nevedie k preúčtovaniu. Požiadavky sú odmietnuté, nie fakturované nad rámec stropu. Riziko sa presúva z finančnej roviny do roviny dostupnosti – čo je presne to, čo chceš, pretože výpadok sa diagnostikuje a opraví za minúty, zatiaľ čo neočakávaný účet sa zistí príliš neskoro.
Keď spotreba dosiahne nastavený limit:
- Požiadavky na API sú odmietnuté so špecifickým chybovým kódom
- API kľúče zostávajú aktívne, ale volania inferencie zlyhajú
- Limit sa resetuje na začiatku ďalšieho fakturačného cyklu
Stratégia limitov podľa prostredia
Pre tím s viacerými projektmi by mal limit odrážať riziko špecifické pre každé prostredie. Vo vývoji je typickým nebezpečenstvom náhodná slučka požiadaviek – testovací skript bežiaci celú noc – a nízky limit 50 až 100 USD zmení túto chybu na incident za 10 USD namiesto prekvapenia za 1 000 USD. Staging spracováva záťažové testy, ktoré legitímne spotrebúvajú viac: mierny limit 200 až 500 USD ponecháva priestor pre testovacie kampane pri zachovaní ochrannej bariéry. Produkcia by však nikdy nemala byť obmedzená do bodu odmietania požiadaviek klientov: vyšší limit (1 000 USD a viac, v závislosti od tvojej prevádzky) prichádza s aktívnym monitorovaním – alert ťa chráni, zatiaľ čo limit je len bezpečnostnou sieťou poslednej inštancie.
Zobrazenie aktuálnych poplatkov
Ak chceš zistiť, kde sa nachádzaš v aktuálnom cykle:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Tento koncový bod vracia poplatky nahromadené od začiatku cyklu. V porovnaní s počtom uplynutých dní ti poskytuje viac než len snapshot: projekciu. Minutie 40 % rozpočtu v jednej tretine mesiaca je zdravé; tých istých 40 % v jednej desatine mesiaca signalizuje prekročenie a ty máš stále dvadsaťsedem dní na konanie.
Automatizácia monitorovania nákladov
Skript pre alert pri dosiahnutí prahu
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Alert pri 80 % limitu
# Získanie 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)
# Získanie aktuálnej spotreby
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)
# Kontrola prahu
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERT: {ratio*100:.1f}% limitu dosiahnuté")
print(f" Míňanie: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Odoslanie notifikácie
Integrácia s monitorovaním
Skombinuj náhľad poplatkov so svojím riešením monitorovania (Grafana, Datadog atď.) a vytvor dashbordy nákladov v reálnom čase:
# Získanie aktuálnej sumy na odoslanie do systému metrík
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
Dynamické upravovanie limitov
Limit nie je na celý fakturačný cyklus stanovený v kameni – a to je dobre, lebo životný cyklus produktu sa neriadi účtovným kalendárom. Pred očakávaným nárastom prevádzky, spustením produktu alebo marketingovou kampaňou limit dočasne zvýš: nič horšie ako platená kampaň, ktorá posiela používateľov na službu, ktorej API odmieta požiadavky kvôli dosiahnutému stropu. Naopak, ak sa rozpočet mesiaca míňa rýchlejšie, než sa čakalo, zníženie limitu pre zvyšok cyklu zmení drift na kontrolované obmedzenie. Najkritickejším prípadom zostáva incident nákladov – slučka v produkcii, zistené zneužitie: okamžité zníženie limitu je tvoje núdzové zastavenie, ktoré zastaví krvácanie, kým nájdeš príčinu.
# Dočasné zvýšenie pre spustenie
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}'
# Resetovanie normálneho limitu po špičke
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}'
Kľúčové poznatky
- Použi
GETaPOSTna/v1/billing/teams/{teamId}/postpaid/spending-limitsna zobrazenie a nastavenie limitov - Po prekročení limitu sú požiadavky na API odmietnuté (žiadne preúčtovanie)
- Náhľad poplatkov (
invoice/preview) ti umožňuje sledovať spotrebu v reálnom čase - Automatizuj alerty pri dosiahnutí prahu, aby si predišiel prekročeniam
- Prispôsob limity podľa prostredia (vývoj, staging, produkcia)