Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Stanje in samodejna polnjenja

Lekcija 11 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Spremljanje in avtomatizacija polnjenj
  2. Preverjanje podrobnosti o stanju
  3. Sistem samodejnega polnjenja
  4. Napovedovanje porabe
  5. Integrirana nadzorna plošča za sledenje
  6. Ključne ugotovitve

Spremljanje in avtomatizacija polnjenj

Kombinacija sledenja predplačniškemu stanju z analitiko uporabe ti omogoča vzpostavitev pametnega sistema polnjenja. Namesto ročnega polnjenja lahko proces avtomatiziraš na podlagi pragov in napovedi porabe.

Preverjanje podrobnosti o stanju

Končna točka vrne dve stvari, ki ju ne smeš zamenjati: trenutno stanje in zgodovino transakcij. Prvo odgovori na vprašanje „Ali lahko še kličem API?”, drugo pa na vprašanje „Kako hitro trošim?”. Drugo je tisto, ki ti omogoča anticipacijo, in zato edino, na katerem lahko temelji avtomatizacija.

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

Odgovor vsebuje trenutno stanje in zgodovino transakcij (nakupi in poraba).

Sistem samodejnega polnjenja

Dobro konfigurirano samodejno polnjenje temelji na dveh številkah, pri čemer je ena pogosto pozabljena. Sprožilni prag mora pokriti tvojo porabo med časom odziva: če preverjaš enkrat na dan, potrebuješ vsaj en dan kredita vnaprej, sicer se bo avtomatizacija sprožila šele po preseku. Mesečna omejitev je varnostni mehanizem, ki najpogosteje manjka – brez nje lahko napaka v zanki tvoje aplikacije sproži polnjenje za polnjenjem, krediti xAI pa niso vračljivi.

Teh dveh vrednosti ne določiš poljubno: naslednji razdelek prikazuje, kako ju izračunati na podlagi tvoje dejanske porabe.

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 polnjenje
TOP_UP_AMOUNT = 200.00   # Znesek polnjenja
MAX_MONTHLY = 1000.00    # Mesečna omejitev

def get_balance():
    """Pridobi trenutno predplačniško stanje."""
    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 skupna polnjenja za trenutni mesec."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filtriraj transakcije za trenutni mesec
    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):
    """Izvedi polnjenje."""
    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 polnjenja
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"Polnjeno ${TOP_UP_AMOUNT:.2f}. Ocenjeno novo stanje: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Napaka med polnjenjem")
    else:
        print(f"Dosežena mesečna omejitev (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Dovolj sredstev: ${balance:.2f}")

Napovedovanje porabe

Napovedovanje spremeni spremljanje v anticipacijo. Sedemdnevno povprečje zadostuje za večino primerov uporabe; da ti da datum izčrpanja, tako da imaš čas za ukrepanje. Le pazi na svojo lastno sezonskost prometa – povprečje, izračunano počasen teden, obljublja avtonomijo, ki bo izginila, ko se promet poveča.

import requests
from datetime import datetime, timedelta

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

# Poraba v zadnjih 7 dneh
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 dnevnega povprečja
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

# Ocena preostalih 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"Povprečna poraba: ${avg_daily_cost:.2f}/dan")
    print(f"Trenutno stanje: ${current_balance:.2f}")
    print(f"Ocenjena izčrpanost: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dni)")

Integrirana nadzorna plošča za sledenje

Nadzorna plošča združuje informacije o tvojih stroških, ki jih poznajo tri različne končne točke: predplačniško stanje, mesečne obremenitve za obračun in konfigurirane omejitve. Ločeno vsaka pripoveduje nepopolno zgodbo – udobno stanje ne pove ničesar o sočasni porabi po plačilu (postpaid). Šele usklajevanje daje pravi strošek trenutnega meseca.

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

# Predplačniško stanje
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 "Predplačniško stanje: \$${BALANCE}"

# Obremenitve po plačilu (Postpaid)
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 "Obremenitve po plačilu: \$${POSTPAID}"

# Omejitev porabe
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 "Mesečna omejitev: \$${LIMIT}"

Ključne ugotovitve

  • Avtomatiziraj polnjenja z minimalnim pragom in mesečno omejitvijo
  • Uporabi analitiko za napovedovanje datumov izčrpanja kredita
  • Združi predplačniško stanje, obremenitve po plačilu in omejitve v enotni nadzorni plošči
  • Krediti niso vračljivi – samodejna polnjenja kalibriraj previdno
  • Te skripte integriraj v svoj cron ali cevovod CI/CD