Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Egyenleg és automatikus feltöltés

11. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Figyeld és automatizáld a feltöltéseket
  2. Ellenőrizd az egyenleg részleteit
  3. Automatikus feltöltési rendszer
  4. Fogyasztási előrejelzés
  5. Integrált követési műszerfal
  6. Főbb megállapítások

Figyeld és automatizáld a feltöltéseket

Ha összekötöd az előrefizetett egyenleg nyomon követését a használati elemzésekkel, intelligens feltöltési rendszert építhetsz ki. A manuális feltöltés helyett automatizálhatod a folyamatot küszöbértékek és fogyasztási előrejelzések alapján.

Ellenőrizd az egyenleg részleteit

A végpont két dolgot ad vissza, amit nem szabad összekeverned: a pillanatnyi egyenleget és a tranzakciós előzményeket. Az első arra a kérdésre válaszol: „Hívhatom még az API-t?“, a második pedig arra: „Milyen gyorsan fogyasztok?“. A második teszi lehetővé az előrejelzést, ezért kizárólag erre alapozhatod az automatizálást.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

A válasz tartalmazza az aktuális egyenleget és a tranzakciós előzményeket (vásárlások és fogyasztás).

Automatikus feltöltési rendszer

A jól beállított automatikus feltöltés két számon múlik, amelyek közül az egyiket gyakran elfelejtik. A trigger küszöbértéknek fedeznie kell a fogyasztást a reakcióidő alatt: ha naponta egyszer ellenőrzöl, legalább egy napnyi hitelre van szükséged előre, különben az automatizálás a leállás után indul be. A havi korlát az a biztonsági háló, ami leggyakrabban hiányzik – enélkül egy hibás ciklus az alkalmazásodban sorozatos feltöltéseket indíthat el, az xAI kreditek pedig nem téríthetők vissza.

Ezt a két értéket nem önkényesen állítjuk be: a következő rész bemutatja, hogyan számítsd ki őket a tényleges fogyasztásod alapján.

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Konfiguráció
MIN_BALANCE = 50.00      # Feltöltési küszöb
TOP_UP_AMOUNT = 200.00   # Feltöltés összege
MAX_MONTHLY = 1000.00    # Havi korlát

def get_balance():
    """Lekéri az aktuális előrefizetett egyenleget."""
    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():
    """Kiszámolja az aktuális hónap teljes feltöltéseit."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Tranzakciók szűrése az aktuális hónapra
    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):
    """Végrehajt egy feltöltést."""
    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

# Feltöltési logika
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"Feltöltés: ${TOP_UP_AMOUNT:.2f}. Becsült új egyenleg: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Hiba történt a feltöltés során")
    else:
        print(f"Havi korlát elérve (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Megfelelő egyenleg: ${balance:.2f}")

Fogyasztási előrejelzés

Az előrejelzés a monitorozást anticipálássá alakítja. A legtöbb felhasználási esetben elegendő a hétnapos átlag; ez megadja a kimerülés várható dátumát, így van időd cselekedni. Csak vigyázz a saját forgalmad szezonalitásával – egy lassú hét alapján számolt átlag olyan autonómiát ígér, ami eltűnik, amint a forgalom felpörög.

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Fogyasztás az elmúlt 7 napban
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"}]
        }
    }
)

# Napi átlag kiszámítása
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

# Hátralévő napok becslése
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"Átlagos fogyasztás: ${avg_daily_cost:.2f}/nap")
    print(f"Aktuális egyenleg: ${current_balance:.2f}")
    print(f"Becsült kimerülés: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} nap)")

Integrált követési műszerfal

A műszerfal egyetlen nézetbe gyűjti össze azt, amit három különböző végpont tud a költségeidről: az előrefizetett egyenleget, a havi számlázási díjakat és a beállított korlátokat. Külön-külön mindegyik hiányos történetet mesél el – egy kényelmes egyenleg semmit nem árul el a párhuzamosan futó utólagos elszámolású (postpaid) fogyasztásról. Az egyeztetés adja meg az aktuális hónap valódi költségét.

#!/bin/bash
echo "=== xAI Műszerfal - $(date '+%m/%d/%Y %H:%M') ==="

# Előrefizetett egyenleg
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 "Előrefizetett egyenleg: \$${BALANCE}"

# Utólagos elszámolású díjak
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 "Utólagos elszámolású díjak: \$${POSTPAID}"

# Költési korlát
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 "Havi korlát: \$${LIMIT}"

Főbb megállapítások

  • Automatizáld a feltöltéseket egy minimális küszöbérték és egy havi korlát beállításával
  • Használd az elemzéseket a kreditkimerülés dátumának előrejelzésére
  • Egyesítsd az előrefizetett egyenleget, az utólagos elszámolású díjakat és a korlátokat egy egységes műszerfalon
  • A kreditek nem téríthetők vissza – óvatosan kalibráld az automatikus feltöltéseket
  • Építsd be ezeket a szkripteket a cron vagy CI/CD folyamataidba