Limity výdajů
Na této stránce
Kontroluj náklady na API
Limity výdajů jsou tvoje finanční pojistka. Nastavují strop, po jehož překročení jsou požadavky na API odmítnuty, což zabraňuje neočekávaným poplatkům na konci měsíce. Management API ti umožňuje tyto limity programově zobrazovat a nastavovat.
Zobrazení aktuálních limitů
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpověď ukazuje aktuální strop cyklu a tvou dosavadní spotřebu – rozdíl mezi nimi je tvá zbývající rezerva. To je jediné číslo, které se denně počítá: strop bez údajů o spotřebě ti neřekne, zda jsi na 10 % nebo na 95 % svého rozpočtu.
Nastavení limitů
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
}'
Chování po překročení
Tady přichází uklidňující část, kterou stojí za to explicitně zdůraznit: dosažení limitu nikdy nevede k přeúčtování. Požadavky jsou odmítnuty, nikoliv účtovány nad rámec stropu. Riziko se přesouvá z finanční roviny do roviny dostupnosti – což je přesně to, co chceš, protože výpadek diagnostikuješ a opravíš během minut, zatímco neočekávaný fakturaci objevíš příliš pozdě.
Když spotřeba dosáhne nastaveného limitu:
- Požadavky na API jsou odmítnuty s konkrétním chybovým kódem
- Klíče API zůstávají aktivní, ale volání inference selžou
- Limit se resetuje na začátku dalšího fakturačního cyklu
Strategie limitů podle prostředí
Pro tým s více projekty by měl limit odrážet riziko specifické pro každé prostředí. Ve vývoji je typickým nebezpečím náhodná smyčka požadavků – testovací skript běžící celou noc – a nízký limit 50 až 100 $ změní tuto chybu na incident za 10 $ místo překvapení za 1 000 $. Staging zpracovává zátěžové testy, které oprávněně spotřebovávají více: mírný limit 200 až 500 $ ponechává prostor pro testovací kampaně při zachování ochranného mechanismu. Produkce by však nikdy neměla být omezována do té míry, aby odmítala požadavky klientů: vyšší limit (1 000 $ a více, v závislosti na tvém provozu) jde ruku v ruce s aktivním monitorováním – alert tě chrání, zatímco limit je jen bezpečnostní síť poslední instance.
Zobrazení aktuálních poplatků
Chceš-li zjistit, kde právě stojíš v rámci běžného cyklu:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Tento koncový bod vrací poplatky nashromážděné od začátku cyklu. Ve srovnání s počtem uplynulých dnů ti poskytuje více než jen okamžitý snímek: nabízí projekci. Spotřeba 40 % rozpočtu v první třetině měsíce je zdravá; stejných 40 % v první desetině měsíce signalizuje překročení a ty máš ještě dvacet sedm dní na reakci.
Automatizace monitorování nákladů
Skript pro alert při dosažení prahu
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Alert při 80 % limitu
# Získání 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ískání aktuální spotřeby
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 dosaženo")
print(f" Útrata: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Odeslat oznámení
Integrace s monitorovacími systémy
Zkombinuj náhled na poplatky se svým monitorovacím řešením (Grafana, Datadog atd.) a vytvoř dashboards nákladů v reálném čase:
# Získání aktuální částky pro odeslání do systému metrik
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á úprava limitů
Limit není pro daný fakturační cyklus vytesán do kamene – a to je dobře, protože životní cyklus produktu se neřídí účetním kalendářem. Před očekávaným nárůstem provozu, spuštěním produktu nebo marketingovou kampaní limit dočasně zvyš: nic horšího než placená kampaň, která posílá uživatele na službu, jejíž API odmítá požadavky kvůli dosaženému stropu. Naopak, pokud je měsíční rozpočet vyčerpán rychleji, než se čekalo, snížení limitu pro zbytek cyklu změní nekontrolovaný drift v řízené omezení. Nejkritičtějším případem zůstává incident spojený s náklady – smyčka v produkci, odhalené zneužití: okamžité snížení limitu je tvé nouzové tlačítko, které zastaví krvácení, zatímco hledáš příčinu.
# Dočasné zvýšení pro spuštění
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}'
# Reset na běžný limit po odeznění špičky
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}'
Klíčové poznatky
- Použij
GETaPOSTna/v1/billing/teams/{teamId}/postpaid/spending-limitspro zobrazení a nastavení limitů - Po překročení limitu jsou požadavky na API odmítnuty (žádné přeúčtování)
- Náhled na poplatky (
invoice/preview) ti umožňuje sledovat spotřebu v reálném čase - Automatizuj alerty při dosažení prahu, abys předešel překročení
- Přizpůsob limity podle prostředí (vývoj, staging, produkce)