Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Limity výdajů

Lekce 7 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Kontroluj náklady na API
  2. Zobrazení aktuálních limitů
  3. Nastavení limitů
  4. Zobrazení aktuálních poplatků
  5. Automatizace monitorování nákladů
  6. Dynamická úprava limitů
  7. Klíčové poznatky

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 GET a POST na /v1/billing/teams/{teamId}/postpaid/spending-limits pro 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)