Ausgabenlimits
Auf dieser Seite
Ihre API-Kosten kontrollieren
Ausgabenlimits sind Ihr finanzielles Sicherheitsnetz. Sie legen ein Deckelwert fest, ab dem API-Anfragen abgelehnt werden, um unerwartete Kosten am Monatsende zu vermeiden. Über die Management-API können Sie diese Limits programmatisch einsehen und anpassen.
Aktuelle Limits einsehen
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Die Antwort zeigt das aktuelle Zyklus-Deckelwert und Ihren aktuellen Verbrauch. Der Unterschied zwischen beiden ergibt Ihre verbleibende Pufferzone. Dies ist die einzige Zahl, die im Tagesgeschäft zählt: Ein Deckelwert ohne Verbrauchsdaten sagt Ihnen nicht, ob Sie sich zu 10 % oder 95 % Ihres Budgets befinden.
Limits festlegen
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"monthlyLimit": 500.00
}'
Verhalten bei Überschreitung
Hier ist der beruhigende Teil, und er sollte ausdrücklich genannt werden: Das Erreichen des Limits führt niemals zu einer Überrechnung. Anfragen werden abgelehnt, nicht über den Cap hinaus berechnet. Das Risiko verschiebt sich von finanzieller Natur zu Verfügbarkeitsproblemen – genau das, was Sie wollen, da eine Ausfallzeit innerhalb weniger Minuten diagnostiziert und behoben wird, während eine unerwartete Rechnung oft zu spät entdeckt wird.
Wenn der Verbrauch das festgelegte Limit erreicht:
- API-Anfragen werden mit einem spezifischen Fehlercode abgelehnt
- API-Schlüssel bleiben aktiv, aber Inferenzaufrufe scheitern
- Das Limit wird zu Beginn des nächsten Abrechnungszyklus zurückgesetzt
Limit-Strategie nach Umgebung
Für ein Team mit mehreren Projekten sollte das Limit das spezifische Risiko jeder Umgebung widerspiegeln. In der Entwicklung besteht die typische Gefahr in einem versehentlichen Anfrage-Loop – ein Testskript, das die ganze Nacht läuft – und ein niedriges Limit von 50,00 bis 100,00 USD verwandelt diesen Fehler in einen Vorfall von 10,00 USD statt in eine Überraschung von 1.000,00 USD. Die Staging-Umgebung verarbeitet Lasttests, die legitimerweise mehr verbrauchen: ein moderates Limit von 200,00 bis 500,00 USD lässt Raum für Testkampagnen, während eine Schutzschranke erhalten bleibt. Die Produktionsumgebung hingegen sollte niemals so gedrosselt werden, dass Kundenanfragen abgelehnt werden: ein höheres Limit (1.000,00 USD und mehr, abhängig vom Datenverkehr) wird mit aktiver Überwachung kombiniert – die Warnung schützt Sie, während das Limit nur das letzte Sicherheitsnetz ist.
Aktuelle Gebühren einsehen
Um zu sehen, wo Sie im aktuellen Zyklus stehen:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dieser Endpunkt gibt die seit Zyklusbeginn angesammelten Gebühren zurück. Im Vergleich zur Anzahl der verstrichenen Tage bietet dies mehr als nur einen Schnappschuss: eine Projektion. 40 % des Budgets zu verbrauchen, wenn ein Drittel des Monats vergangen ist, ist gesund; dasselbe von 40 % bei nur einem Zehntel des Monats signalisiert eine Überschreitung, und Sie haben immer noch 27 Tage Zeit, zu handeln.
Kostenüberwachung automatisieren
Skript für Schwellenwert-Warnungen
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Warnung bei 80 % des Limits
# Limit abrufen
limits_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/spending-limits",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
monthly_limit = limits_resp.json().get("monthlyLimit", 0)
# aktuellen Verbrauch abrufen
preview_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/invoice/preview",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_spend = preview_resp.json().get("totalAmount", 0)
# Schwellenwert prüfen
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERT: {ratio*100:.1f}% des Limits erreicht")
print(f" Ausgaben: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Benachrichtigung senden
Integration in Überwachungslösungen
Kombinieren Sie die Gebührenvorschau mit Ihrer Überwachungslösung (Grafana, Datadog usw.), um Echtzeit-Kosten-Dashboards zu erstellen:
# aktuellen Betrag abrufen, um ihn an Ihr Metrik-System zu senden
CURRENT_SPEND=$(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', 0))")
echo "xai.billing.current_spend:$CURRENT_SPEND|g" | nc -u -w1 localhost 8125
Limits dynamisch anpassen
Das Limit ist für den Abrechnungszyklus nicht festgelegt – und das ist eine gute Sache, da der Produktlebenszyklus nicht dem Finanzkalender folgt. Vor einem erwarteten Datenverkehrsspitze, einem Produktlaunch oder einer Marketingkampagne können Sie das Limit vorübergehend erhöhen: nichts ist schlimmer als eine bezahlte Kampagne, die Nutzer auf einen Dienst leitet, dessen API Anfragen ablehnt, weil das Limit erreicht ist. Umgekehrt kann das Senken des Limits für den Rest des Zyklus, wenn das Budget des Monats schneller als erwartet aufgebraucht ist, Drift in eine kontrollierte Einschränkung verwandeln. Der kritischste Fall bleibt ein Kosten-Vorfall – ein Loop in der Produktion, erkannter Missbrauch: Das sofortige Senken des Limits ist Ihr Not-Aus-Schalter, der die Blutung stoppt, während Sie die Ursache finden.
# Limit vorübergehend für einen Launch erhöhen
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 2000.00}'
# normales Limit nach der Spitze zurücksetzen
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 500.00}'
Kernaussagen
GETundPOSTauf/v1/billing/teams/{teamId}/postpaid/spending-limitszum Einsehen und Festlegen von Limits- Bei Überschreitung des Limits werden API-Anfragen abgelehnt (keine Überrechnung)
- Die Gebührenvorschau (
invoice/preview) ermöglicht die Echtzeit-Verfolgung des Verbrauchs - Automatisieren Sie Schwellenwertwarnungen, um Überschreitungen vorherzusehen
- Passen Sie Limits an die Umgebung an (Entwicklung, Staging, Produktion)