Saldo i doładowania automatyczne
Na tej stronie
Monitorowanie i automatyzacja doładowań
Połączenie monitorowania salda przedpłaconego z analityką zużycia pozwala skonfigurować inteligentny system doładowań. Zamiast zasilać konto ręcznie, możesz zautomatyzować ten proces w oparciu o progi zużycia i prognozy konsumpcji.
Sprawdzanie szczegółów salda
Punkt końcowy zwraca dwie rzeczy, których nie należy mylić: saldo bieżące oraz historię transakcji. Pierwsze odpowiada na pytanie „Czy nadal mogę wywoływać API?“, drugie na „Jak szybko zużywam środki?“. To właśnie drugie pozwala na antycypację, dlatego tylko na nim możesz oprzeć automatyzację.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpowiedź zawiera aktualne saldo oraz historię transakcji (zakupy i konsumpcja).
System automatycznego doładowania
Prawidłowo skonfigurowane automatyczne doładowanie opiera się na dwóch liczbach, z których jedną często się pomija. Próg wyzwalacza musi pokrywać Twoje zużycie w czasie reakcji systemu: jeśli sprawdzasz saldo raz dziennie, potrzebujesz co najmniej jednodniowego kredytu z wyprzedzeniem, w przeciwnym razie automatyzacja uruchomi się dopiero po przekroczeniu limitu. Miesięczny limit to zabezpieczenie, którego najczęściej brakuje – bez niego błędna pętla w aplikacji może wyzwalać doładowanie za doładowaniem, a kredyty xAI nie podlegają zwrotowi.
Te dwie wartości nie są ustalane arbitralnie: następna sekcja pokazuje, jak je obliczyć na podstawie rzeczywistego zużycia.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Konfiguracja
MIN_BALANCE = 50.00 # Próg doładowania
TOP_UP_AMOUNT = 200.00 # Kwota doładowania
MAX_MONTHLY = 1000.00 # Miesięczny limit
def get_balance():
"""Pobierz aktualne saldo przedpłacone."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
return resp.json().get("balance", 0)
def get_monthly_top_ups():
"""Oblicz całkowitą kwotę doładowań w bieżącym miesiącu."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtruj transakcje dla bieżącego miesiąca
transactions = resp.json().get("transactions", [])
current_month = datetime.now().strftime("%Y-%m")
monthly_total = sum(
t.get("amount", 0)
for t in transactions
if t.get("type") == "top-up" and t.get("date", "").startswith(current_month)
)
return monthly_total
def top_up(amount):
"""Wykonaj doładowanie."""
resp = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={"amount": amount}
)
return resp.status_code == 200
# Logika doładowania
balance = get_balance()
monthly_spent = get_monthly_top_ups()
if balance < MIN_BALANCE:
remaining_budget = MAX_MONTHLY - monthly_spent
if remaining_budget >= TOP_UP_AMOUNT:
if top_up(TOP_UP_AMOUNT):
print(f"Doładowanie o ${TOP_UP_AMOUNT:.2f}. Szacowane nowe saldo: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Błąd podczas doładowania")
else:
print(f"Osiągnięto miesięczny limit (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Wystarczające saldo: ${balance:.2f}")
Prognozowanie zużycia
Prognozowanie zamienia monitorowanie w antycypację. Średnia z siedmiu dni wystarcza w większości przypadków użycia; daje Ci datę wyczerpania środków, więc masz czas na reakcję. Uważaj jednak na sezonowość własnego ruchu – średnia obliczona w tygodniu o małym natężeniu obiecuje autonomię, która zniknie, gdy ruch wzrośnie.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Zużycie z ostatnich 7 dni
end = datetime.now()
start = end - timedelta(days=7)
usage_resp = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={
"analyticsRequest": {
"timeRange": {
"startTime": start.strftime("%Y-%m-%d %H:%M:%S"),
"endTime": end.strftime("%Y-%m-%d %H:%M:%S"),
"timezone": "Europe/Paris"
},
"timeUnit": "DAY",
"values": [{"name": "cost", "aggregation": "SUM"}]
}
}
)
# Oblicz średnią dzienną
data_points = usage_resp.json().get("dataPoints", [])
daily_costs = [p.get("value", 0) for p in data_points]
avg_daily_cost = sum(daily_costs) / len(daily_costs) if daily_costs else 0
# Oszacuj pozostałe dni
balance_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_balance = balance_resp.json().get("balance", 0)
if avg_daily_cost > 0:
days_remaining = current_balance / avg_daily_cost
exhaustion_date = datetime.now() + timedelta(days=days_remaining)
print(f"Średnie zużycie: ${avg_daily_cost:.2f}/dzień")
print(f"Aktualne saldo: ${current_balance:.2f}")
print(f"Szacowane wyczerpanie: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dni)")
Zintegrowany panel monitorowania
Panel zestawia informacje o kosztach pochodzące z trzech różnych punktów końcowych: saldo przedpłacone, miesięczne opłaty rozliczeniowe oraz skonfigurowane limity. Rozdzielone, każdy z nich opowiada niepełną historię – komfortowe saldo nic nie mówi o równolegle biegnącej konsumpcji rozliczanej post factum. To właśnie uzgodnienie tych danych daje prawdziwy koszt bieżącego miesiąca.
#!/bin/bash
echo "=== Panel xAI - $(date '+%m/%d/%Y %H:%M') ==="
# Saldo przedpłacone
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 'N/A'))")
echo "Saldo przedpłacone: \$${BALANCE}"
# Opłaty post factum
POSTPAID=$(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', 'N/A'))")
echo "Opłaty post factum: \$${POSTPAID}"
# Limit wydatków
LIMIT=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('monthlyLimit', 'N/A'))")
echo "Limit miesięczny: \$${LIMIT}"
Kluczowe wnioski
- Automatyzuj doładowania, ustawiając minimalny próg i miesięczny limit
- Wykorzystuj analitykę do prognozowania dat wyczerpania kredytu
- Łącz saldo przedpłacone, opłaty post factum i limity w zunifikowanym panelu
- Kredyty nie podlegają zwrotowi – kalibruj automatyczne doładowania z ostrożnością
- Zintegruj te skrypty z harmonogramem cron lub potokiem CI/CD