Vorkasse-Guthaben
Auf dieser Seite
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.
- Verfügbares Vorkasse-Guthaben: Token werden vom Guthaben abgezogen
- Guthaben erschöpft: Der Verbrauch wechselt zur monatlichen Abrechnung (Nachzahlung)
- 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/balancegibt den Kontostand und die Historie zurückPOST /v1/billing/teams/{teamId}/prepaid/top-upkauft 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