Limity wydatków
Na tej stronie
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
GETiPOSTna/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)