Rechnungsdaten verwalten
Auf dieser Seite
Rechnungsdaten über die API verwalten
Der Bereich Rechnungswesen der Management-API ermöglicht es Ihnen, Ihre Rechnungsdaten abzurufen und zu aktualisieren, Rechnungen herunterzuladen und den Verbrauch programmatisch zu überwachen. Sie müssen nicht mehr zwischen der Konsole und der API hin- und herwechseln, um den Zahlungstatus zu prüfen.
Rechnungsdaten abrufen
Rechnungsdaten scheinen zunächst harmlos, bis die Buchhaltung eine Rechnung ablehnt, weil der Firmenname falsch ist oder die Umsatzsteuer-Identifikationsnummer fehlt. Die Überprüfung über die API erfolgt mit nur einer Anfrage und verhindert einen nicht mehr korrigierbaren Fehler: Wie in der folgenden Anmerkung erläutert, kann eine bereits ausgestellte Rechnung mit neuen Details nicht neu generiert werden.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Die Antwort enthält die registrierten Rechnungsdaten: Firmenname, Adresse, Land und ggf. die Umsatzsteuer-Identifikationsnummer.
Informationen aktualisieren
Um Ihre Rechnungsdaten zu ändern:
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"companyName": "My Company SAS",
"address": "15 Peace Street",
"city": "Paris",
"country": "FR",
"vatNumber": "FR12345678901"
}'
Wichtige Anmerkung zu bestehenden Rechnungen
Aktualisierte Rechnungsdaten gelten nur für zukünftige Rechnungen. Eine bereits ausgestellte Rechnung kann nicht nachträglich mit neuen Details neu generiert werden. Prüfen Sie Ihre Daten vor dem Ende des Abrechnungszyklus, um die Genauigkeit der Rechnungen sicherzustellen.
Rechnungen abrufen
Der Endpunkt GET /v1/billing/teams/{teamId}/invoices gibt die Historie Ihrer Rechnungen zurück:
# Rechnungen für einen bestimmten Monat
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Rechnungen ab einem bestimmten Monat
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Filterparameter
- billingCycle.year und billingCycle.month: Abrufen von Rechnungen für einen bestimmten Zyklus
- since.year und since.month: Abrufen aller Rechnungen ab einem bestimmten Monat
Rechnungszustände
Von diesen vier Zuständen erfordert nur einer sofortiges Handeln. FAILED bedeutet, dass die Belastung nicht durchgeführt wurde (abgelaufene Karte, Limit erreicht, Streitfall). Eine unbezahlte Rechnung führt schließlich zur Dienstleistungsaussetzung. Dies ist der Status, den Sie automatisch überwachen müssen, wie in der Lektion über Zahlungsmethoden gezeigt; die anderen drei Zustände werden überprüft, aber nur bei diesem Status wird ein Alarm ausgelöst.
- PENDING: Die Rechnung wird verarbeitet; die Zahlung wurde noch nicht belastet
- PAID: Die Zahlung war erfolgreich
- FAILED: Die Belastung fehlgeschlagen (abgelaufene Karte, unzureichende Guthaben etc.)
- WILL_NEVER_BE_CHARGED: Die Rechnung wird nie belastet (Gutschrift, Anpassung)
xAI-Rechnungslogik
Das Verständnis der Wechselwirkung zwischen den beiden Modi verhindert Missinterpretationen des Dashboards. Vorabguthaben werden zuerst verwendet; die monatliche Abrechnung setzt erst ein, sobald das Guthaben aufgebraucht ist. Ein Guthaben von null bei aktivem Dienst ist keine Anomalie: Sie verbrauchen nun nach Abrechnung (Postpaid), und die Monatsrechnung sammelt sich an.
Vorabguthaben
Gekaufte Guthaben werden zum Zeitpunkt des Kaufs sofort belastet. Jeder API-Aufruf verbraucht Guthaben basierend auf der Anzahl der verarbeiteten Tokens. Guthaben werden zuerst verwendet.
Monatliche Abrechnung (Postpaid)
Wenn Ihre Guthaben aufgebraucht sind oder Sie keines haben, wird der Verbrauch am Ende des Monats abgerechnet. Die Kosten für jeden API-Aufruf werden sofort berechnet, die Belastung erfolgt jedoch am Ende des Zyklus.
Unterschiede bei der Token-Zählung
Erwarten Sie eine Diskrepanz zwischen Ihrer lokalen Zählung und der Abrechnungszählung. Es ist besser, dies zu wissen, bevor Sie einen halben Tag damit verbringen, sie aufzuspüren. Die Abrechnung ist autoritativ: Stützen Sie Ihre Kostenschätzungen auf die Zahlen der Analytics-API, niemals auf eine Zählung, die mit einem clientseitigen Tokenisierer durchgeführt wurde. Dies ist normal: Inferenz-Endpunkte fügen interne Tokens für die Verarbeitung hinzu (Systemanweisungen, Formatierung), was die berechnete Anzahl im Vergleich zum Rohtext leicht erhöht.
Aktuelle Belastungen anzeigen
Um die angesammelten Belastungen vor Zyklusende einzusehen:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dieser Vorschaubericht ist der einzige Weg, um den aktuellen Betrag zu kennen, bevor die Rechnung ausgestellt wird. Eine Überprüfung einmal pro Woche macht die monatliche Abrechnung zu etwas Beherrschbarem: Sie erkennen Kostenabweichungen in der Mitte des Zyklus, wenn noch Zeit bleibt, den Datenverkehr auf ein günstigeres Modell umzuleiten oder ein Limit zu senken.
Kernaussagen
GETundPOSTauf/v1/billing/teams/{teamId}/billing-infozum Abrufen und Ändern von Informationen- Rechnungen haben 4 Zustände: PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
- Rechnungsänderungen sind nicht rückwirkend auf bestehende Rechnungen
- xAI kombiniert Vorabguthaben (Priorität) und monatliche Abrechnung
- Die Kosten-Vorschau (
invoice/preview) ermöglicht es, Kosten vorherzusehen