Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Bilanċ u rikariki awtomatiċi

Lezzjoni 11 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Immonitorja u awtomatizza r-rikariki
  2. Iċċekkja d-dettalji tal-bilanċ
  3. Sistema ta’ rikarika awtomatika
  4. Tbassir tal-konsum
  5. Dashboard integrat tat-traċċar
  6. Punti Ewlenin

Immonitorja u awtomatizza r-rikariki

Il-kombinazzjoni tat-traċċar tal-bilanċ imħallas minn qabel mal-analitika tal-użu tippermettilek tistabbilixxi sistema intelliġenti ta’ rikarika. Minflok ma tagħmel rikarika manwali, tista’ tawtomatizza l-proċess ibbażat fuq limiti (thresholds) u tbassir tal-konsum.

Iċċekkja d-dettalji tal-bilanċ

L-endpoint jirritorna żewġ affarijiet li m’għandekx tħawwad: il-bilanċ istantanju u l-istoriku tat-tranżazzjonijiet. L-ewwel wieħed iwieġeb “Nista’ għadni nsejjaħ l-API?”, it-tieni wieħed iwieġeb “Kemm qed nieħu veloċità fil-konsum?”. It-tieni wieħed huwa dak li jħallik tbassar, u għalhekk huwa l-uniku wieħed li fuqu tista’ tibni l-awtomazzjoni.

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

Ir-risposta fiha l-bilanċ kurrenti u l-istoriku tat-tranżazzjonijiet (xirjiet u konsum).

Sistema ta’ rikarika awtomatika

Sistema ta’ rikarika awtomatika kkonfigurata tajjeb tiddependi fuq żewġ numri, u wieħed minnhom spiss jiġi minsija. Il-limitu ta’ attivazzjoni (trigger threshold) irid ikopri l-konsum tiegħek matul il-ħin ta’ reazzjoni: jekk tiċċekkja darba kuljum, għandek bżonn mill-inqas kreditu ta’ jum minn qabel, inkella l-awtomazzjoni se tiġi attivata wara li jkun għadda l-limitu. Il-limitu mensili huwa s-salvagwardja li spiss tonqos—mingħajru, ċiklu difettuż fl-applikazzjoni tiegħek jista’ jattiva rikarika wara oħra, u l-krediti ta’ xAI ma jiġux rimborsati.

Dawn iż-żewġ valuri ma jiġux stabbiliti b’mod arbitrarju: it-taqsima li jmiss turi kif tikkalkulahom ibbażat fuq il-konsum attwali tiegħek.

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}")

Tbassir tal-konsum

It-tbassir ibiddel l-immonitorjaġġ f’antiċipazzjoni. Medja ta’ sebat ijiem hija biżżejjed għall-biċċa l-kbira tal-każijiet ta’ użu; tagħtik data ta’ eżawriment, sabiex ikollok ħin biex taġixxi. Kun biss attenta għall-istaġjonalità tat-traffiku tiegħek stess—medja kkalkulata fuq ġimgħa bil-mod twiegħed awtonomija li se tisparixxi hekk kif it-traffiku jiżdied.

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)")

Dashboard integrat tat-traċċar

Id-dashboard jiġbor flimkien dak li tliet endpoints differenti jafu dwar l-ispejjeż tiegħek: il-bilanċ imħallas minn qabel, il-ħlasijiet tal-fatturazzjoni mensili, u l-limiti kkonfigurati. Meta jkunu separati, kull wieħed jgħid storja mhux kompluta—bilanċ komdu ma jgħid xejn dwar il-konsum “postpaid” li qed jiġri parallelament. Hija r-rikonċiljazzjoni li tagħti l-ispiża vera tax-xahar kurrenti.

#!/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}"

Punti Ewlenin

  • Awtomatizza r-rikariki b’limitu minimu u limitu mensili
  • Uża l-analitika biex tbassar id-dati ta’ eżawriment tal-kreditu
  • Għaqqad il-bilanċ imħallas minn qabel, il-ħlasijiet “postpaid”, u l-limiti f’dashboard unifikat
  • Il-krediti ma jiġux rimborsati—ikkalibra r-rikariki awtomatiċi b’kawtela
  • Integra dawn l-iskripts fil-cron jew fil-pipeline CI/CD tiegħek