Zůstatek a automatické dobíjení
Na této stránce
Sledování a automatizace dobíjení
Kombinace sledování předplaceného zůstatku s analytikou využití ti umožní nastavit chytrý systém dobíjení. Místo ručního dobíjení můžeš celý proces automatizovat na základě prahových hodnot a prognóz spotřeby.
Kontrola podrobností o zůstatku
Koncový bod vrací dvě věci, které si nesmíš plést: okamžitý zůstatek a historii transakcí. První odpovídá na otázku „Můžu ještě volat API?“, druhá na otázku „Jak rychle spotřebovávám kredity?“. Právě druhá hodnota ti umožňuje předvídat vývoj, a je tedy jedinou, na které můžeš založit automatizaci.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpověď obsahuje aktuální zůstatek a historii transakcí (nákupy a spotřeba).
Systém automatického dobíjení
Správně nakonfigurované automatické dobíjení se opírá o dvě čísla, přičemž jedno z nich se často zapomíná. Spouštěcí práh musí pokrýt tvou spotřebu během doby reakce: pokud kontroluješ stav jednou denně, potřebuješ mít k dispozici kredit alespoň na jeden den dopředu, jinak se automatizace spustí až po vyčerpání prostředků. Měsíční strop je pojistka, která nejčastěji chybí – bez ní může chybná smyčka v tvé aplikaci spustit dobíjení za dobíjením a kredity xAI nejsou vratné.
Tyto dvě hodnoty se nestanovují libovolně: následující sekce ukazuje, jak je vypočítat na základě tvé skutečné spotřeby.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Konfigurace
MIN_BALANCE = 50.00 # Prahová hodnota pro dobíjení
TOP_UP_AMOUNT = 200.00 # Částka pro dobíjení
MAX_MONTHLY = 1000.00 # Měsíční strop
def get_balance():
"""Získá aktuální předplacený zůstatek."""
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():
"""Vypočítá celkovou сумму dobíjení za aktuální měsíc."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtruje transakce za aktuální měsíc
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):
"""Provede dobíjení."""
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 dobíjení
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"Dobito ${TOP_UP_AMOUNT:.2f}. Odhadovaný nový zůstatek: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Chyba při dobíjení")
else:
print(f"Dosažen měsíční strop (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Dostatečný zůstatek: ${balance:.2f}")
Predikce spotřeby
Predikce mění pouhé sledování v anticipaci. Pro většinu případů použití stačí sedmidenní průměr; ten ti dá datum vyčerpání prostředků, takže máš čas zareagovat. Dej si však pozor na sezónnost vlastního provozu – průměr vypočítaný během klidného týdne slibuje autonomii, která zmizí, jakmile provoz nabere na obrátkách.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Spotřeba za posledních 7 dní
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"}]
}
}
)
# Výpočet denního průměru
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
# Odhad zbývajících dnů
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"Průměrná spotřeba: ${avg_daily_cost:.2f}/den")
print(f"Aktuální zůstatek: ${current_balance:.2f}")
print(f"Odhadované vyčerpání: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dnů)")
Integrovaný sledovací dashboard
Dashboard sjednocuje informace o tvých nákladech, které znají tři různé koncové body: předplacený zůstatek, měsíční fakturační poplatky a nastavené limity. Odděleně vypráví každý jen neúplný příběh – komfortní zůstatek nic neříká o souběžně běžící platbě po spotřebě (postpaid). Až jejich vzájemné sladění poskytne skutečnou cenu za aktuální měsíc.
#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="
# Předplacený zůstatek
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 "Předplacený zůstatek: \$${BALANCE}"
# Poplatky po spotřebě (Postpaid)
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 "Poplatky po spotřebě: \$${POSTPAID}"
# Limit útrat
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 "Měsíční limit: \$${LIMIT}"
Klíčové poznatky
- Automatizuj dobíjení pomocí minimálního prahu a měsíčního stropu
- Využívej analytiku k predikci dat vyčerpání kreditů
- Kombinuj předplacený zůstatek, poplatky po spotřebě a limity v jednotném dashboardu
- Kredity nejsou vratné – kalibruj automatické dobíjení s opatrností
- Integruj tyto skripty do svého cronu nebo CI/CD pipeline