Przejdź do głównej treści
Polski— Wybierz język
Menu

Limity wydatków

Lekcja 7 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Kontroluj koszty swojego API
  2. Przeglądanie bieżących limitów
  3. Ustawianie limitów
  4. Przeglądanie bieżących opłat
  5. Automatyzacja monitorowania kosztów
  6. Dynamiczna adjustacja limitów
  7. Kluczowe wnioski

Kontroluj koszty swojego API

Limity wydatków to Twoja finansowa siatka bezpieczeństwa. Wyznaczają one pułap, powyżej którego żądania API są odrzucane, co zapobiega nieoczekiwanym obciążeniom na koniec miesiąca. Management API pozwala Ci programowo przeglądać i ustawiać te limity.

Przeglądanie bieżących limitów

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

Odpowiedź zawiera obecny pułap dla danego cyklu oraz Twoje bieżące zużycie – co w praktyce oznacza, że różnica między nimi to Twój pozostały margines. To jedyna liczba, która ma znaczenie na co dzień: sam pułap bez danych o zużyciu nie powie Ci, czy wykorzystałeś już 10%, czy 95% swojego budżetu.

Ustawianie limitów

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

Zachowanie po przekroczeniu limitu

Oto uspokajająca część, którą warto wyraźnie podkreślić: osiągnięcie limitu nigdy nie skutkuje naliczeniem opłat ponad ustaloną kwotę. Żądania są odrzucane, a nie rozliczane powyżej capu. Ryzyko przenosi się z finansowego na dostępność – a dokładnie tego chcesz, ponieważ awarię zdiagnozujesz i naprawisz w ciągu kilku minut, podczas gdy niespodziewany rachunek odkryjesz zbyt późno.

Gdy zużycie osiągnie ustawiony limit:

  • Żądania API są odrzucone ze specyficznym kodem błędu
  • Klucze API pozostają aktywne, ale wywołania wnioskowania (inference) kończą się niepowodzeniem
  • Limit resetuje się na początku następnego cyklu rozliczeniowego

Strategia limitów w zależności od środowiska

W przypadku zespołu pracującego nad wieloma projektami limit powinien odzwierciedlać ryzyko specyficzne dla każdego środowiska. W środowisku deweloperskim typowym zagrożeniem jest przypadkowa pętla żądań – skrypt testowy działający całą noc – więc niski limit rzędu 50–100 USD zamieni taki błąd w incydent kosztujący 10 USD, a nie w niespodziankę za 1000 USD. Środowisko staging obsługuje testy obciążeniowe, które legalnie zużywają więcej zasobów: umiarkowany limit 200–500 USD pozostawia miejsce na kampanie testowe, zachowując jednocześnie zabezpieczenie. Produkcja natomiast nigdy nie powinna być dławiona do punktu odmawiania obsługi żądań klientów: wyższy limit (1000 USD i więcej, w zależności od ruchu) idzie w parze z aktywnym monitoringiem – alert Cię chroni, natomiast limit stanowi jedynie ostateczną siatkę bezpieczeństwa.

Przeglądanie bieżących opłat

Aby sprawdzić, na jakim etapie jesteś w bieżącym cyklu:

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

Ten endpoint zwraca opłaty naliczone od początku cyklu. W zestawieniu z liczbą dni, które już minęły, daje Ci więcej niż tylko migawkę: otrzymujesz prognozę. Wykorzystanie 40% budżetu w pierwszej trzeciej miesiąca jest zdrowe; te same 40% w pierwszej dziesiątej części miesiąca sygnalizują przekroczenie, a Ty masz jeszcze dwadzieścia siedem dni, aby zareagować.

Automatyzacja monitorowania kosztów

Skrypt alertu progowego

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Alert przy 80% limitu

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

# Pobierz bieżące zużycie
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)

# Sprawdź próg
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"ALERT: {ratio*100:.1f}% limitu osiągnięte")
        print(f"  Wydatki: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Wyślij powiadomienie

Integracja z systemami monitoringu

Połącz podgląd opłat ze swoim rozwiązaniem monitorującym (Grafana, Datadog itp.), aby stworzyć dashboards kosztów w czasie rzeczywistym:

# Pobierz bieżącą kwotę, aby wysłać ją do systemu metryk
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

Dynamiczna adjustacja limitów

Limit nie jest ustawiony w kamieniu na cały cykl rozliczeniowy – i to dobrze, ponieważ życie produktu nie podlega kalendarzowi księgowemu. Przed oczekiwanym skokiem ruchu, uruchomieniem produktu lub kampanią marketingową tymczasowo zwiększ limit: nic gorszego niż płatna kampania kierująca użytkowników do usługi, której API odmawia obsługi żądań z powodu osiągniętego pułapu. Odwrotnie, jeśli budżet miesiąca zostanie wydany szybciej niż oczekiwano, obniżenie limitu na pozostałą część cyklu zamienia dryfowanie w kontrolowane ograniczenie. Najbardziej krytycznym przypadkiem pozostaje incydent kosztowy – pętla w produkcji, wykryte nadużycie: natychmiastowe obniżenie limitu to Twój przycisk awaryjny, który tamuje krwawienie, podczas gdy Ty szukasz przyczyny.

# Tymczasowe zwiększenie na potrzeby uruchomienia
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 do normalnego limitu po skoku
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}'

Kluczowe wnioski

  • Używaj GET i POST na /v1/billing/teams/{teamId}/postpaid/spending-limits, aby przeglądać i ustawiać limity
  • Po przekroczeniu limitu żądania API są odrzucane (brak naliczania opłat ponad limit)
  • Podgląd opłat (invoice/preview) pozwala śledzić zużycie w czasie rzeczywistym
  • Automatyzuj alerty progowe, aby wyprzedzać przekroczenia
  • Dostosowuj limity do środowiska (dev, staging, production)