Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Zostatok a automatické dobíjanie

Lekcia 11 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Monitorovanie a automatizácia dobíjania
  2. Kontrola podrobností o zostatku
  3. Systém automatického dobíjania
  4. Predpoveď spotreby
  5. Integrovaný sledovací dashboard
  6. Kľúčové poznatky

Monitorovanie a automatizácia dobíjania

Kombinácia sledovania predplateného zostatku s analytikou využívania ti umožňuje nastaviť inteligentný systém dobíjania. Namiesto manuálneho dobíjania môžeš tento proces automatizovať na základe prahových hodnôt a prognóz spotreby.

Kontrola podrobností o zostatku

Koncový bod vracia dve veci, ktoré by si si nemal mýliť: okamžitý zostatok a históriu transakcií. Prvý odpovedá na otázku „Môžem stále volať API?“, druhý na otázku „Ako rýchlo míňam kredity?“. Práve druhý údaj ti umožňuje predvídať budúci vývoj, a preto je jediným, na ktorom môžeš založiť automatizáciu.

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

Odozva obsahuje aktuálny zostatok a históriu transakcií (nákupy a spotreba).

Systém automatického dobíjania

Dobre nakonfigurované automatické dobíjanie sa spolieha na dve čísla, pričom na jedno sa často zabúda. Spúšťací prah musí pokrývať tvoju spotrebu počas času reakcie: ak kontroluješ stav raz denne, potrebuješ mať k dispozícii kredit aspoň na jeden deň vopred, inak sa automatizácia spustí až po vyčerpaní zostatku. Mesiacný limit je ochranným mechanizmom, ktorý najčastejšie chýba – bez neho môže chybná slučka v tvojej aplikácii spustiť dobíjanie za dobíjaním a kredity xAI nie je možné vrátiť.

Tieto dve hodnoty nie sú nastavené ľubovoľne: nasledujúca časť ukazuje, ako ich vypočítať na základe tvojej skutočnej spotreby.

import requests
from datetime import datetime, timedelta

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

# Konfigurácia
MIN_BALANCE = 50.00      # Prah pre dobíjanie
TOP_UP_AMOUNT = 200.00   # Suma dobíjania
MAX_MONTHLY = 1000.00    # Mesačný limit

def get_balance():
    """Získať aktuálny predplatený zostatok."""
    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():
    """Vypočítať celkové sumy dobíjaní za aktuálny mesiac."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filtrovať transakcie za aktuálny mesiac
    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):
    """Vykonať dobíjanie."""
    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 dobíjania
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"Dobitie o ${TOP_UP_AMOUNT:.2f}. Odhadovaný nový zostatok: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Chyba počas dobíjania")
    else:
        print(f"Dosiahnutý mesačný limit (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Dostatočný zostatok: ${balance:.2f}")

Predpoveď spotreby

Predpovedanie mení monitorovanie na anticipáciu. Pre väčšinu prípadov použitia stačí sedemdňový priemer; poskytne ti dátum vyčerpania, takže máš čas konať. Daj si však pozor na sezónnosť tvojej vlastnej premávky – priemer vypočítaný počas slabého týždňa sľubuje autonómiu, ktorá zmizne, akonáhle premávka naberie na obrátkach.

import requests
from datetime import datetime, timedelta

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

# Spotreba za posledných 7 dní
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"}]
        }
    }
)

# Vypočítať denný priemer
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

# Odhadnúť zostávajúce 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"Priemerná spotreba: ${avg_daily_cost:.2f}/deň")
    print(f"Aktuálny zostatok: ${current_balance:.2f}")
    print(f"Odhadované vyčerpanie: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dní)")

Integrovaný sledovací dashboard

Dashboard spája informácie o tvojich nákladoch, ktoré poznajú tri rôzne koncové body: predplatený zostatok, mesačné fakturačné poplatky a nakonfigurované limity. Oddelene každý z nich rozpráva neúplný príbeh – pohodlný zostatok nič nehovorí o súbežnej spotrebe na fakturačnom (postpaid) účte. Až zosúladenie týchto údajov poskytuje skutočnú cenu za aktuálny mesiac.

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

# Predplatený zostatok
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 "Predplatený zostatok: \$${BALANCE}"

# Poplatky za postpaid služby
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 "Poplatky za postpaid služby: \$${POSTPAID}"

# Limit míňania
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 "Mesačný limit: \$${LIMIT}"

Kľúčové poznatky

  • Automatizuj dobíjanie pomocou minimálneho prahu a mesačného limitu
  • Využi analytiku na predpovedanie dátumov vyčerpania kreditov
  • Skombinuj predplatený zostatok, postpaid poplatky a limity do jednotného dashboardu
  • Kredity nie je možné vrátiť – kalibruj automatické dobíjanie opatrne
  • Integruj tieto skripty do svojho cronu alebo CI/CD pipeline