Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Saldo und automatische Nachbuchungen

Lektion 11 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Überwachung und Automatisierung von Nachbuchungen
  2. Saldodetails prüfen
  3. Automatisiertes Nachbuchungssystem
  4. Verbrauchsprognose
  5. Integrierter Überwachungs-Dashboard
  6. Kernaussagen

Überwachung und Automatisierung von Nachbuchungen

Die Kombination aus der Verfolgung des Guthabens und der Nutzungsanalyse ermöglicht die Einrichtung eines intelligenten Nachbuchungssystems. Anstatt manuell nachzubuchen, können Sie den Prozess basierend auf Schwellenwerten und Verbrauchsprognosen automatisieren.

Saldodetails prüfen

Der Endpunkt liefert zwei Informationen, die nicht verwechselt werden dürfen: das sofortige Guthaben und die Transaktionshistorie. Die erste Antwortet auf die Frage „Kann ich die API noch aufrufen?”, die zweite auf „Wie schnell verbrauche ich?”. Die zweite ist diejenige, die es ermöglicht, vorzusehen, und daher die einzige Basis für Automatisierung.

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

Die Antwort enthält das aktuelle Guthaben und die Transaktionshistorie (Käufe und Verbrauch).

Automatisiertes Nachbuchungssystem

Ein gut konfiguriertes automatisches Nachbuchungssystem stützt sich auf zwei Zahlen, wovon eine oft vergessen wird. Die Auslöseschwelle muss Ihren Verbrauch während der Reaktionszeit abdecken: Wenn Sie einmal täglich prüfen, benötigen Sie mindestens einen Tag Guthaben im Voraus, sonst wird die Automatisierung erst nach dem Abbruch ausgelöst. Die monatliche Obergrenze ist die am häufigsten fehlende Sicherung – ohne sie kann ein fehlerhafter Schleifenlauf in Ihrer Anwendung eine Nachbuchung nach der anderen auslösen, und xAI-Guthaben sind nicht erstattungsfähig.

Diese beiden Werte werden nicht willkürlich festgelegt: Der nächste Abschnitt zeigt, wie Sie sie basierend auf Ihrem tatsächlichen Verbrauch berechnen.

import requests
from datetime import datetime, timedelta

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

# Konfiguration
MIN_BALANCE = 50.00      # Nachbuchungsschwelle
TOP_UP_AMOUNT = 200.00   # Nachbuchungsbetrag
MAX_MONTHLY = 1000.00    # Monatliche Obergrenze

def get_balance():
    """Holt das aktuelle Guthaben."""
    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():
    """Berechnet die Gesamtnachbuchungen für den aktuellen Monat."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filtert Transaktionen für den aktuellen Monat
    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):
    """Führt eine Nachbuchung durch."""
    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

# Nachbuchungslogik
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"Nachbuchung von ${TOP_UP_AMOUNT:.2f}. Geschätztes neues Guthaben: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Fehler während der Nachbuchung")
    else:
        print(f"Monatliche Obergrenze erreicht (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Ausreichendes Guthaben: ${balance:.2f}")

Verbrauchsprognose

Eine Prognose verwandelt die Überwachung in Antizipation. Ein sieben-Tage-Durchschnitt reicht für die meisten Anwendungsfälle aus; er liefert ein Datum für die vollständige Erschöpfung, sodass Sie Zeit zum Handeln haben. Achten Sie jedoch auf Ihre eigene saisonale Verkehrsmuster – ein Durchschnitt, der über eine langsame Woche berechnet wird, verspricht Autonomie, die verschwindet, sobald der Verkehr zunimmt.

import requests
from datetime import datetime, timedelta

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

# Verbrauch der letzten 7 Tage
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"}]
        }
    }
)

# Berechnet den täglichen Durchschnitt
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

# Schätzt die restlichen Tage
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"Durchschnittlicher Verbrauch: ${avg_daily_cost:.2f}/Tag")
    print(f"Aktuelles Guthaben: ${current_balance:.2f}")
    print(f"Geschätzte Erschöpfung: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} Tage)")

Integrierter Überwachungs-Dashboard

Das Dashboard vereint, was drei verschiedene Endpunkte über Ihre Kosten wissen: das Guthaben, die monatlichen Abrechnungsgebühren und die konfigurierten Limits. Getrennt erzählt jede Komponente eine unvollständige Geschichte – ein komfortables Guthaben sagt nichts über parallele Postpaid-Verbräuche aus. Erst die Abrechnung ergibt die wahren Kosten des aktuellen Monats.

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

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

# Postpaid-Gebühren
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-Gebühren: \$${POSTPAID}"

# Ausgabenlimit
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 "Monatliches Limit: \$${LIMIT}"

Kernaussagen

  • Automatisieren Sie Nachbuchungen mit einer Mindestschwelle und einer monatlichen Obergrenze.
  • Nutzen Sie Analysen, um Datenpunkte für die Erschöpfung von Guthaben vorherzusagen.
  • Kombinieren Sie Guthaben, Postpaid-Gebühren und Limits in einem einheitlichen Dashboard.
  • Guthaben sind nicht erstattungsfähig – kalibrieren Sie automatische Nachbuchungen mit Vorsicht.
  • Integrieren Sie diese Skripte in Ihren Cron- oder CI/CD-Pipeline.