Management-API: Verwaltung von Schlüsseln und Abrechnung
Auf dieser Seite
Verwalten Sie Ihr Konto ohne Konsole
Die xAI Management-API ist eine REST-Schnittstelle, die sich der Verwaltung Ihres Enterprise-Kontos widmet. Während die Inferenz-API (api.x.ai) Modelle aufruft, verwaltet die Management-API (management-api.x.ai) Ihre Ressourcen. Der Unterschied mag zunächst gering erscheinen. Er ist es nicht. Alles, was sonst jemanden erfordern würde, die Webkonsole zu öffnen und zu klicken, kann hier automatisiert werden – nachvollziehbar, reproduzierbar und integrierbar mit den Werkzeugen, die Ihre Teams bereits nutzen.
Schlüssel bereitstellen und rotieren
Die Erstellung von Schlüsseln über die API ermöglicht die Automatisierung der Bereitstellung für eine neue Anwendung oder Umgebung:
curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "cle-production-chatbot",
"acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
"qps": 10,
"qpm": 100,
"tpm": 1000000,
"expireTime": "2026-12-31T23:59:59Z"
}'
Die Parameter in dieser Anforderung definieren vollständig den Geltungsbereich des Schlüssels:
- name: Menschlich lesbarer Identifier für den Schlüssel
- acls: Liste der Berechtigungen (autorisierte Endpunkte und Modelle)
- qps/qpm/tpm: Ratenbegrenzungen pro Sekunde, pro Minute und Tokens pro Minute
- expireTime: Automatisches Ablaufdatum
Das Festlegen von expireTime bei der Erstellung ist die Gewohnheit, die Sie langfristig am meisten vor Problemen bewahrt: Ein Schlüssel, der für eine dreimonatige Pilotphase ausgestellt wurde, läuft von selbst ab, anstatt unendlich in einer Konfigurationsdatei zu überdauern, die niemand mehr liest.
Die regelmäßige Schlüsselrotation folgt denselben Sicherheitsstandards. Der dedizierte Endpunkt generiert einen neuen Geheimhaltungsschlüssel und ungültigt den alten:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Warnung: Der alte Geheimhaltungsschlüssel wird sofort und endgültig ungültig. Bereiten Sie vor, den neuen Wert in Ihrem Geheimhaltungsmanager zu bereitstellen, bevor Sie den Befehl ausführen, niemals danach. Drei readonly-Endpunkte vervollständigen das Set: GET /auth/teams/{teamId}/api-keys listet alle Schlüssel für das Team auf, GET /auth/api-keys/{apiKeyId}/propagation überprüft, ob der Schlüssel an allen Knoten propagiert wurde, und GET /auth/teams/{teamId}/models listet zugängliche Modelle mit ihren Preisen auf. Der zweite ist derjenige, den Sie direkt nach einer Rotation konsultieren, wenn eine Anwendung noch Authentifizierungsfehler zurückgibt und Sie nicht sicher sind, ob es sich um einen Anwendungsfehler oder lediglich um eine Propagationsverzögerung handelt.
Abrechnung verfolgen und steuern
Das Abrufen von Abrechnungsinformationen erfolgt über einen dedizierten Endpunkt:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Sie rufen die Historie von Rechnungen mit einer Filterung nach Zeitraum ab, hier für März 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Jede Rechnung trägt einen Status unter PENDING, PAID, FAILED und WILL_NEVER_BE_CHARGED. Das Aufzeigen eines FAILED-Status in Ihrer Überwachung ist weit besser, als über einen Dienstausfall am Montagmorgen davon zu erfahren.
Um Budgetüberschreitungen zu verhindern, konfigurieren Sie eine monatliche Obergrenze:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 5000}'
Wenn Sie auf_prepaid_arbeiten, überprüfen Sie den Saldo auf dieselbe Weise:
# Saldo prüfen
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Denken Sie daran, dass_prepaid_-Gutschriften nicht erstattungsfähig sind, es sei denn, dies ist gesetzlich vorgeschrieben. Dimensionieren Sie Ihre Einkäufe basierend auf dem Verbrauch, der über mehrere Wochen beobachtet wurde, nicht auf optimistischen Wachstumsprognosen.
Überwachen Sie Ihren Verbrauch mit der richtigen Granularität
Der Analytics-Endpunkt ermöglicht es Ihnen, die Nutzung mit feiner Granularität zu verfolgen:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}'
Diese Anforderung gibt den täglichen Tokenverbrauch zurück, unterteilt nach Modell, für März. Durch das Ändern von timeUnit wechseln Sie von einer monatlichen Ansicht zu einer pro-Minuten-Ansicht: Mögliche Werte sind MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR und MINUTE. Aggregationen gehen weit über einfache Summen hinaus, mit SUM, AVG, MIN, MAX, P50, P90, P99 und COUNT. Prozentile charakterisieren die Last effektiv, da Durchschnitte die sehr Spitzen glätten, die die Kapazität bestimmen, die Sie tatsächlich benötigen.
Die Management-API nimmt dann ihren Platz in Ihrer Werkzeugkette ein. Sie bereitstellen Schlüssel aus Terraform oder Pulumi genau wie eine Datenbank, Ihre CI/CD-Pipeline erstellt temporäre Schlüssel für Testumgebungen und löscht sie am Ende der Ausführung, Überwachungsskripte alarmieren, bevor die Ausgabenbegrenzung erreicht ist, und Ihre internen Dashboards zeigen den Verbrauch an, ohne dass ein Mensch jede Woche einen CSV-Export durchführen muss.
Kernaussagen
- Die Management-API auf management-api.x.ai verwaltet Schlüssel, Abrechnung und Metriken
- Schlüsselrotation ungültigt den alten Geheimhaltungsschlüssel endgültig
- Ausgabenbegrenzungen schützen vor Budgetüberschreitungen
- Nutzungsanalysen bieten Granularität von Minute bis Monat
- Integrieren Sie die Management-API in Ihre Infrastrukturgezeuge, um die Administration zu automatisieren