Saldo ja automaattiset täydennykset
Tällä sivulla
Seuraa ja automatisoi täydennykset
Yhdistämällä ennakkomaksusaldon seurannan käyttöanalytiikkaan voit rakentaa älykkään täydennysjärjestelmän. Manuaalisen täydentämisen sijaan voit automatisoida prosessin kynnysarvojen ja kulutusennusteiden perusteella.
Tarkista saldotiedot
Päätepiste palauttaa kaksi asiaa, joita ei pidä sekoittaa: hetkellisen saldon ja transaktiohistorian. Ensimmäinen vastaa kysymykseen “Voinko vielä kutsua APIa?”, kun taas toinen vastaa kysymykseen “Kuinka nopeasti kulutan?”. Juuri toinen mahdollistaa ennakoinnin, ja siksi se on ainoa, johon automaation voi perustaa.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Vastaus sisältää nykyisen saldon ja transaktiohistorian (ostot ja kulutus).
Automaattinen täydennysjärjestelmä
Hyvin konfiguroitu automaattinen täydennys perustuu kahteen lukuun, joista toinen unohdetaan usein. Käynnistyskynnyksen on katettava kulutuksesi reaktioajan aikana: jos tarkistat tilanteen kerran päivässä, tarvitset vähintään yhden päivän luottoa etukäteen, muuten automaatio käynnistyy katkaisun jälkeen. Kuukausikatto on useimmiten puuttuva varmistus – ilman sitä sovelluksesi virheellinen silmukka voi laukaista täydennyksen toisensa perään, eikä xAI-hyvityksiä hyvitetä.
Näitä kahta arvoa ei aseteta mielivaltaisesti: seuraavassa osiossa näytetään, kuinka ne lasketaan todellisen kulutuksesi perusteella.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Configuration
MIN_BALANCE = 50.00 # Top-up threshold
TOP_UP_AMOUNT = 200.00 # Top-up amount
MAX_MONTHLY = 1000.00 # Monthly cap
def get_balance():
"""Get the current prepaid balance."""
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():
"""Calculate the total top-ups for the current month."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filter transactions for the current month
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):
"""Perform a top-up."""
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
# Top-up logic
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"Top-up of ${TOP_UP_AMOUNT:.2f}. Estimated new balance: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Error during top-up")
else:
print(f"Monthly cap reached (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Sufficient balance: ${balance:.2f}")
Kulutusennusteet
Ennustaminen muuttaa seurannan ennakoinniksi. Useimpiin käyttötarkoituksiin riittää seitsemän päivän keskiarvo; se antaa sinulle arvioidun loppumispäivän, joten sinulla on aikaa toimia. Varo kuitenkin omaa liikenteesi kausivaihtelua – hitaan viikon yli laskettu keskiarvo lupaa toimintavarmuutta, joka haihtuu liikenteen vilkastuessa.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Consumption over the last 7 days
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"}]
}
}
)
# Calculate daily average
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
# Estimate remaining days
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"Average consumption: ${avg_daily_cost:.2f}/day")
print(f"Current balance: ${current_balance:.2f}")
print(f"Estimated exhaustion: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} days)")
Integroitu seurantanäkymä
Näkymä kokoaa yhteen tiedot, jotka kolme eri päätepistettä tietää kuluistasi: ennakkomaksusaldo, kuukausittaiset laskutusmaksut ja määritetyt rajat. Erotettuina kukin kertoo vain epätäydellisen tarinan – mukava saldo ei kerro mitään rinnakkain pyörivästä jälkikäteen laskutettavasta kulutuksesta. Vasta täsmäytys paljastaa kuluvan kuukauden todelliset kustannukset.
#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="
# Prepaid balance
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 "Prepaid balance: \$${BALANCE}"
# Postpaid charges
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 "Postpaid charges: \$${POSTPAID}"
# Spending limit
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 "Monthly limit: \$${LIMIT}"
Keskeiset asiat
- Automatisoi täydennykset määrittämällä vähimmäiskynnys ja kuukausikatto
- Käytä analytiikkaa ennustaaksesi luoton loppumispäiviä
- Yhdistä ennakkomaksusaldo, jälkikäteen laskutettavat maksut ja rajat yhdeksi kokonaisnäkymäksi
- Hyvityksiä ei hyvitetä – kalibroi automaattiset täydennykset huolellisesti
- Integroi nämä skriptit cron-tehtäviin tai CI/CD-putkeen