Przejdź do głównej treści
Polski— Wybierz język
Menu

Saldo i doładowania automatyczne

Lekcja 11 z 14 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Monitorowanie i automatyzacja doładowań
  2. Sprawdzanie szczegółów salda
  3. System automatycznego doładowania
  4. Prognozowanie zużycia
  5. Zintegrowany panel monitorowania
  6. Kluczowe wnioski

Monitorowanie i automatyzacja doładowań

Połączenie monitorowania salda przedpłaconego z analityką zużycia pozwala skonfigurować inteligentny system doładowań. Zamiast zasilać konto ręcznie, możesz zautomatyzować ten proces w oparciu o progi zużycia i prognozy konsumpcji.

Sprawdzanie szczegółów salda

Punkt końcowy zwraca dwie rzeczy, których nie należy mylić: saldo bieżące oraz historię transakcji. Pierwsze odpowiada na pytanie „Czy nadal mogę wywoływać API?“, drugie na „Jak szybko zużywam środki?“. To właśnie drugie pozwala na antycypację, dlatego tylko na nim możesz oprzeć automatyzację.

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

Odpowiedź zawiera aktualne saldo oraz historię transakcji (zakupy i konsumpcja).

System automatycznego doładowania

Prawidłowo skonfigurowane automatyczne doładowanie opiera się na dwóch liczbach, z których jedną często się pomija. Próg wyzwalacza musi pokrywać Twoje zużycie w czasie reakcji systemu: jeśli sprawdzasz saldo raz dziennie, potrzebujesz co najmniej jednodniowego kredytu z wyprzedzeniem, w przeciwnym razie automatyzacja uruchomi się dopiero po przekroczeniu limitu. Miesięczny limit to zabezpieczenie, którego najczęściej brakuje – bez niego błędna pętla w aplikacji może wyzwalać doładowanie za doładowaniem, a kredyty xAI nie podlegają zwrotowi.

Te dwie wartości nie są ustalane arbitralnie: następna sekcja pokazuje, jak je obliczyć na podstawie rzeczywistego zużycia.

import requests
from datetime import datetime, timedelta

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

# Konfiguracja
MIN_BALANCE = 50.00      # Próg doładowania
TOP_UP_AMOUNT = 200.00   # Kwota doładowania
MAX_MONTHLY = 1000.00    # Miesięczny limit

def get_balance():
    """Pobierz aktualne saldo przedpłacone."""
    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():
    """Oblicz całkowitą kwotę doładowań w bieżącym miesiącu."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filtruj transakcje dla bieżącego miesiąca
    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):
    """Wykonaj doładowanie."""
    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 doładowania
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"Doładowanie o ${TOP_UP_AMOUNT:.2f}. Szacowane nowe saldo: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Błąd podczas doładowania")
    else:
        print(f"Osiągnięto miesięczny limit (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Wystarczające saldo: ${balance:.2f}")

Prognozowanie zużycia

Prognozowanie zamienia monitorowanie w antycypację. Średnia z siedmiu dni wystarcza w większości przypadków użycia; daje Ci datę wyczerpania środków, więc masz czas na reakcję. Uważaj jednak na sezonowość własnego ruchu – średnia obliczona w tygodniu o małym natężeniu obiecuje autonomię, która zniknie, gdy ruch wzrośnie.

import requests
from datetime import datetime, timedelta

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

# Zużycie z ostatnich 7 dni
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"}]
        }
    }
)

# Oblicz średnią dzienną
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

# Oszacuj pozostałe 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"Średnie zużycie: ${avg_daily_cost:.2f}/dzień")
    print(f"Aktualne saldo: ${current_balance:.2f}")
    print(f"Szacowane wyczerpanie: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dni)")

Zintegrowany panel monitorowania

Panel zestawia informacje o kosztach pochodzące z trzech różnych punktów końcowych: saldo przedpłacone, miesięczne opłaty rozliczeniowe oraz skonfigurowane limity. Rozdzielone, każdy z nich opowiada niepełną historię – komfortowe saldo nic nie mówi o równolegle biegnącej konsumpcji rozliczanej post factum. To właśnie uzgodnienie tych danych daje prawdziwy koszt bieżącego miesiąca.

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

# Saldo przedpłacone
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 "Saldo przedpłacone: \$${BALANCE}"

# Opłaty post factum
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 "Opłaty post factum: \$${POSTPAID}"

# Limit wydatków
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 "Limit miesięczny: \$${LIMIT}"

Kluczowe wnioski

  • Automatyzuj doładowania, ustawiając minimalny próg i miesięczny limit
  • Wykorzystuj analitykę do prognozowania dat wyczerpania kredytu
  • Łącz saldo przedpłacone, opłaty post factum i limity w zunifikowanym panelu
  • Kredyty nie podlegają zwrotowi – kalibruj automatyczne doładowania z ostrożnością
  • Zintegruj te skrypty z harmonogramem cron lub potokiem CI/CD