Stanje i automatsko dopunjavanje
Na ovoj stranici
Praćenje i automatizacija dopunjavanja
Kombiniranjem praćenja stanja unaprijed plaćenog kredita s analizom korištenja možeš postaviti pametan sustav za dopunjavanje. Umjesto ručnog dopunjavanja, proces možeš automatizirati na temelju pragova i prognoza potrošnje.
Provjera detalja o stanju
Krajnja točka vraća dvije stvari koje ne smiješ brkati: trenutno stanje i povijest transakcija. Prvo odgovara na pitanje „Mogu li još uvijek zvati API?“, a drugo na pitanje „Koliko brzo trošim?“. Drugo je ono što ti omogućuje anticipaciju, pa je stoga jedino na temelju čega možeš graditi automatizaciju.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor sadrži trenutno stanje i povijest transakcija (kupnje i potrošnja).
Sustav automatskog dopunjavanja
Dobro konfigurirano automatsko dopunjavanje oslanja se na dva broja, a jedan od njih se često zaboravlja. Prag okidača mora pokriti tvoju potrošnju tijekom vremena reakcije: ako provjeravaš jednom dnevno, trebaš imati kredit za barem jedan dan unaprijed, inače će se automatizacija aktivirati tek nakon što prijeđeš granicu. Mjesečni limit je sigurnosna mjera koja najčešće nedostaje—bez nje, pogrešna petlja u tvojoj aplikaciji može izazvati dopunjavanje za dopunjavanjem, a xAI krediti se ne vraćaju.
Ove dvije vrijednosti nisu postavljene proizvoljno: sljedeći odjeljak pokazuje kako ih izračunati na temelju tvoje stvarne potrošnje.
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 dopunjavanje
TOP_UP_AMOUNT = 200.00 # Iznos dopunjavanja
MAX_MONTHLY = 1000.00 # Mjesečni limit
def get_balance():
"""Dohvati trenutno stanje unaprijed plaćenog kredita."""
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 ukupna dopunjavanja za tekući mjesec."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtriraj transakcije za tekući mjesec
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):
"""Izvrši dopunjavanje."""
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 dopunjavanja
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"Dopunjeno ${TOP_UP_AMOUNT:.2f}. Procijenjeno novo stanje: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Greška tijekom dopunjavanja")
else:
print(f"Mjesečni limit dosegnut (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Dovoljno sredstava: ${balance:.2f}")
Prognoza potrošnje
Prognoziranje pretvara praćenje u anticipaciju. Sedmodnevni prosjek dovoljan je za većinu slučajeva upotrebe; daje ti datum iscrpljivanja kredita, tako da imaš vremena djelovati. Samo pazi na vlastitu sezonalnost prometa—prosjek izračunat tijekom tjedna slabog prometa obećava autonomiju koja će nestati čim promet poraste.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Potrošnja u posljednjih 7 dana
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 dnevnog prosjeka
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
# Procjena preostalih dana
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"Prosječna potrošnja: ${avg_daily_cost:.2f}/dan")
print(f"Trenutno stanje: ${current_balance:.2f}")
print(f"Procijenjeno iscrpljivanje: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dana)")
Integrirana nadzorna ploča za praćenje
Nadzorna ploča objedinjuje ono što tri različite krajnje točke znaju o tvojim troškovima: stanje unaprijed plaćenog kredita, mjesečne naknade za obračun i konfigurirane limite. Odvojeno, svaka priča nepotpunu priču—udobno stanje ne govori ništa o potrošnji po obračunu koja teče paralelno. Tek usklađivanje daje stvarni trošak tekućeg mjeseca.
#!/bin/bash
echo "=== xAI Nadzorna ploča - $(date '+%m/%d/%Y %H:%M') ==="
# Stanje unaprijed plaćenog kredita
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 "Stanje unaprijed plaćenog kredita: \$${BALANCE}"
# Naknade po obračunu
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 "Naknade po obračunu: \$${POSTPAID}"
# Limit potrošnje
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 "Mjesečni limit: \$${LIMIT}"
Ključne točke
- Automatiziraj dopunjavanje s minimalnim pragom i mjesečnim limitom
- Koristi analitiku za prognozu datuma iscrpljivanja kredita
- Kombiniraj stanje unaprijed plaćenog kredita, naknade po obračunu i limite u jedinstvenoj nadzornoj ploči
- Krediti se ne vraćaju—kalibriraj automatska dopunjavanja s oprezom
- Integriraj ove skripte u svoj cron ili CI/CD pipeline