Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Vorkasse-Guthaben

Lektion 8 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Das xAI-Vorkasse-Modell
  2. Ihren Kontostand prüfen
  3. Guthaben kaufen (Nachschub)
  4. Strategien für die Guthaben-Nutzung
  5. Überwachung des Kontostands
  6. Kernaussagen

Das xAI-Vorkasse-Modell

Mit Vorkasse-Guthaben können Sie ein Guthaben im Voraus erwerben, das bei der Erstellung von API-Aufrufen verbraucht wird. Dieses Modell eignet sich ideal zur Kontrolle der Ausgaben: Sie geben nur aus, was Sie gekauft haben, und es gibt keine unangenehmen Überraschungen am Monatsende. Das Guthaben wird vor der monatlichen Abrechnung verwendet.

Ihren Kontostand prüfen

Vorkasse kehrt die Risikobeziehung im Vergleich zur monatlichen Abrechnung um. Bei der Nachzahlung entdecken Sie den Betrag erst am Ende des Monats; bei der Vorkasse wird das Limit im Voraus festgelegt und das Worst-Case-Szenario ist eine Dienstunterbrechung – unangenehm, aber begrenzt. Für ein Team, das die API erkundet, oder für ein Projekt mit festem Budget ist dies der richtige Kompromiss.

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

Die Antwort enthält:

  • Den aktuellen Kontostand in US-Dollar
  • Die Nachschub-Historie mit Daten und Beträgen
  • Die Nutzungshistorie nach Perioden

Guthaben kaufen (Nachschub)

Um Ihr Guthaben aufzuladen:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

Wichtige Punkte zum Guthaben

Die folgenden vier Punkte haben konkrete Auswirkungen darauf, wie Sie Automatisierungen umsetzen. Der zweite Punkt ist besonders wichtig: Guthaben sind nicht erstattungsfähig. Allein dies schließt die Strategie eines einzelnen großen Kaufs „zur Sicherheit” aus – moderate, häufige Nachschübe sind besser, auch wenn Sie diese automatisieren, als Kapital in einem Projekt gebunden zu halten, das sich möglicherweise in Richtung ändern könnte.

  • Guthaben werden sofort beim Kauf auf Ihrer Standard-Zahlungsmethode belastet
  • Vorkasse-Guthaben sind nicht erstattungsfähig (es sei denn, dies ist gesetzlich in Ihrer Rechtsordnung vorgeschrieben)
  • Guthaben werden prioritär vor der monatlichen Nachzahlungsabrechnung verbraucht
  • Es ist kein Ablaufdatum für Guthaben angegeben – sie bleiben verfügbar, bis sie verbraucht sind

Abrechnungsablauf mit Guthaben

Es lohnt sich, die Verbrauchsreihenfolge zu kennen, bevor Sie etwas konfigurieren, da dies bestimmt, was Ihre Dashboards anzeigen. Guthaben gehen zuerst, die monatliche Abrechnung übernimmt danach: Mit anderen Worten bedeutet ein stagnierendes Guthaben bei Vorkasse auf Null, während alles funktioniert, dass Sie bereits unbemerkt auf die Nachzahlung umgestiegen sind.

  1. Verfügbares Vorkasse-Guthaben: Token werden vom Guthaben abgezogen
  2. Guthaben erschöpft: Der Verbrauch wechselt zur monatlichen Abrechnung (Nachzahlung)
  3. Ausgabenlimit erreicht: Anfragen werden abgelehnt

Strategien für die Guthaben-Nutzung

Festes monatliches Budget

Dies ist die Strategie des harten Budgets: Ohne aktiviertes monatliches Abrechnungsmodell stoppen die Anfragen, wenn das Guthaben erschöpft ist, anstatt Schulden zu verursachen. Akzeptieren Sie den Kompromiss – der Dienst unterbricht sich, und es ist besser, dass dies eine bewusste Entscheidung ist als eine Entdeckung am Freitagabend. Kombinieren Sie dies mit der Warnung bei niedrigem Guthaben, die weiter unten beschrieben wird.

import requests
from datetime import datetime

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

# Kontostand prüfen
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)

# Nachschub, wenn Guthaben niedrig ist
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00

if balance < RECHARGE_THRESHOLD:
    top_up_amount = MONTHLY_BUDGET - balance
    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": top_up_amount}
    )
    print(f"Nachgeschoben ${top_up_amount:.2f}")

Projektbereitstellung

Die Projektbereitstellung bietet einen Vorteil über die Buchhaltung hinaus: Das Guthaben wird zu einer Maßnahme des Fortschritts. Wenn die Hälfte des Guthabens verbraucht ist, während ein Viertel der Arbeit erledigt wurde, erhalten Sie diese Information vor dem Ende, wenn es noch Zeit gibt, zu entscheiden, ob der Umfang reduziert oder das Modell gewechselt werden soll.

# Projektbudget: 500,00 $ über 3 Monate
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500.00}'

Überwachen Sie dann die Nutzung über die Analysen (nächste Lektion), um sicherzustellen, dass das Budget eingehalten wird.

Überwachung des Kontostands

Warnung bei niedrigem Guthaben

#!/bin/bash
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', 0))")

THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
    echo "WARNUNG: niedriger Vorkasse-Kontostand ($BALANCE $)"
    # Senden Sie eine Benachrichtigung
fi

Nutzungsdashboard

Kombinieren Sie das Guthaben bei Vorkasse mit der Vorschau der Nachzahlungslast für einen vollständigen Überblick über Ihre Kosten:

# Guthaben bei Vorkasse
echo "=== Vorkasse-Guthaben ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Aktuelle Nachzahlungslasten
echo "=== Nachzahlungslasten ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Kernaussagen

  • GET /v1/billing/teams/{teamId}/prepaid/balance gibt den Kontostand und die Historie zurück
  • POST /v1/billing/teams/{teamId}/prepaid/top-up kauft Guthaben (sofort belastet)
  • Vorkasse-Guthaben sind nicht erstattungsfähig
  • Guthaben werden vor der monatlichen Abrechnung verbraucht
  • Automatisieren Sie Nachschübe mit einem Mindestschwellenwert, um Unterbrechungen zu vermeiden
  • Kombinieren Sie Guthaben bei Vorkasse und Ausgabenlimits für die vollständige Kostenkontrolle