Stanje in samodejna polnjenja
Na tej strani
Spremljanje in avtomatizacija polnjenj
Kombinacija sledenja predplačniškemu stanju z analitiko uporabe ti omogoča vzpostavitev pametnega sistema polnjenja. Namesto ročnega polnjenja lahko proces avtomatiziraš na podlagi pragov in napovedi porabe.
Preverjanje podrobnosti o stanju
Končna točka vrne dve stvari, ki ju ne smeš zamenjati: trenutno stanje in zgodovino transakcij. Prvo odgovori na vprašanje „Ali lahko še kličem API?”, drugo pa na vprašanje „Kako hitro trošim?”. Drugo je tisto, ki ti omogoča anticipacijo, in zato edino, na katerem lahko temelji avtomatizacija.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor vsebuje trenutno stanje in zgodovino transakcij (nakupi in poraba).
Sistem samodejnega polnjenja
Dobro konfigurirano samodejno polnjenje temelji na dveh številkah, pri čemer je ena pogosto pozabljena. Sprožilni prag mora pokriti tvojo porabo med časom odziva: če preverjaš enkrat na dan, potrebuješ vsaj en dan kredita vnaprej, sicer se bo avtomatizacija sprožila šele po preseku. Mesečna omejitev je varnostni mehanizem, ki najpogosteje manjka – brez nje lahko napaka v zanki tvoje aplikacije sproži polnjenje za polnjenjem, krediti xAI pa niso vračljivi.
Teh dveh vrednosti ne določiš poljubno: naslednji razdelek prikazuje, kako ju izračunati na podlagi tvoje dejanske porabe.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Konfiguracija
MIN_BALANCE = 50.00 # Prag za polnjenje
TOP_UP_AMOUNT = 200.00 # Znesek polnjenja
MAX_MONTHLY = 1000.00 # Mesečna omejitev
def get_balance():
"""Pridobi trenutno predplačniško stanje."""
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():
"""Izračunaj skupna polnjenja za trenutni mesec."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtriraj transakcije za trenutni mesec
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):
"""Izvedi polnjenje."""
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 polnjenja
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"Polnjeno ${TOP_UP_AMOUNT:.2f}. Ocenjeno novo stanje: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Napaka med polnjenjem")
else:
print(f"Dosežena mesečna omejitev (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Dovolj sredstev: ${balance:.2f}")
Napovedovanje porabe
Napovedovanje spremeni spremljanje v anticipacijo. Sedemdnevno povprečje zadostuje za večino primerov uporabe; da ti da datum izčrpanja, tako da imaš čas za ukrepanje. Le pazi na svojo lastno sezonskost prometa – povprečje, izračunano počasen teden, obljublja avtonomijo, ki bo izginila, ko se promet poveča.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Poraba v zadnjih 7 dneh
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"}]
}
}
)
# Izračun dnevnega povprečja
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
# Ocena preostalih 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"Povprečna poraba: ${avg_daily_cost:.2f}/dan")
print(f"Trenutno stanje: ${current_balance:.2f}")
print(f"Ocenjena izčrpanost: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dni)")
Integrirana nadzorna plošča za sledenje
Nadzorna plošča združuje informacije o tvojih stroških, ki jih poznajo tri različne končne točke: predplačniško stanje, mesečne obremenitve za obračun in konfigurirane omejitve. Ločeno vsaka pripoveduje nepopolno zgodbo – udobno stanje ne pove ničesar o sočasni porabi po plačilu (postpaid). Šele usklajevanje daje pravi strošek trenutnega meseca.
#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="
# Predplačniško stanje
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 "Predplačniško stanje: \$${BALANCE}"
# Obremenitve po plačilu (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 "Obremenitve po plačilu: \$${POSTPAID}"
# Omejitev porabe
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 "Mesečna omejitev: \$${LIMIT}"
Ključne ugotovitve
- Avtomatiziraj polnjenja z minimalnim pragom in mesečno omejitvijo
- Uporabi analitiko za napovedovanje datumov izčrpanja kredita
- Združi predplačniško stanje, obremenitve po plačilu in omejitve v enotni nadzorni plošči
- Krediti niso vračljivi – samodejna polnjenja kalibriraj previdno
- Te skripte integriraj v svoj cron ali cevovod CI/CD