Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Saldo ja automaattiset täydennykset

Oppitunti 11 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Seuraa ja automatisoi täydennykset
  2. Tarkista saldotiedot
  3. Automaattinen täydennysjärjestelmä
  4. Kulutusennusteet
  5. Integroitu seurantanäkymä
  6. Keskeiset asiat

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