Salt la conținutul principal
Română— Alege o limbă
Meniu

Sold și reîncărcări automate

Lecția 11 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Monitorizarea și automatizarea reîncărcărilor
  2. Verificarea detaliilor soldului
  3. Sistemul de reîncărcare automată
  4. Previziunea consumului
  5. Panou de control integrat pentru urmărire
  6. Puncte cheie

Monitorizarea și automatizarea reîncărcărilor

Combinarea urmăririi soldului preplătit cu analizele de utilizare vă permite să configurați un sistem inteligent de reîncărcare. În loc să efectuați reîncărcări manuale, puteți automatiza procesul pe baza unor praguri și a previziunilor de consum.

Verificarea detaliilor soldului

Endpoint-ul returnează două elemente pe care nu trebuie să le confundați: soldul instantaneu și istoricul tranzacțiilor. Primul răspunde la întrebarea „Mai pot apela API-ul?“, iar al doilea la „Cu ce viteză consum?“. Al doilea este cel care vă permite să anticipați și, prin urmare, singurul pe care vă puteți baza pentru automatizare.

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

Răspunsul conține soldul curent și istoricul tranzacțiilor (achiziții și consum).

Sistemul de reîncărcare automată

Un sistem de reîncărcare automată bine configurat se bazează pe două valori, dintre care una este adesea uitată. Pragul de declanșare trebuie să acopere consumul dumneavoastră pe durata timpului de reacție: dacă verificați o dată pe zi, aveți nevoie de cel puțin o zi de credit în avans; altfel, automatizarea se va declanșa după depășirea limitei. Plafonul lunar este măsura de siguranță care lipsește cel mai adesea—fără acesta, o buclă defectuoasă în aplicația dumneavoastră poate declanșa reîncărcare după reîncărcare, iar creditele xAI nu sunt rambursabile.

Aceste două valori nu sunt stabilite arbitrar: secțiunea următoare arată cum să le calculați pe baza consumului dumneavoastră real.

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

Previziunea consumului

Previziunea transformă monitorizarea în anticipare. O medie pe șapte zile este suficientă pentru majoritatea cazurilor de utilizare; aceasta vă oferă o dată estimată de epuizare, astfel încât să aveți timp să acționați. Aveți grijă însă la sezonalitatea propriului trafic—o medie calculată pe o săptămână lentă promite o autonomie care va dispărea imediat ce traficul crește.

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

Panou de control integrat pentru urmărire

Panoul de control reunește informațiile despre costurile dumneavoastră cunoscute de trei endpoint-uri diferite: soldul preplătit, facturile lunare și limitele configurate. Luate separat, fiecare spune o poveste incompletă—un sold confortabil nu indică nimic despre consumul postplătit care rulează în paralel. Reconcilierea acestor date oferă costul real al lunii curente.

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

Puncte cheie

  • Automatizați reîncărcările folosind un prag minim și un plafon lunar
  • Utilizați analizele pentru a previziona datele de epuizare a creditului
  • Combinați soldul preplătit, taxele postplătite și limitele într-un panou de control unificat
  • Creditele nu sunt rambursabile—calibrați reîncărcările automate cu prudență
  • Integrați aceste scripturi în cron sau în pipeline-ul CI/CD