Basis-URL und erster Aufruf
Auf dieser Seite
Die Management-API: Eine getrennte Steuerungs-Ebene
Die Management-API von xAI unterscheidet sich von der Inferenz-API, die Sie verwenden, um Prompts an Grok zu senden. Mit ihr verwalten Sie Ihre Ressourcen: Sie erstellen und verwalten API-Schlüssel, konfigurieren die Abrechnung, überwachen die Nutzung und steuern den Zugriff Ihres Teams. Diese Verwaltung erfolgt über eine dedizierte URL.
Basis-URL
Diese Trennung ist kein Implementierungsdetail: Sie spiegelt einen grundlegenden Unterschied zwischen den beiden APIs wider. Die eine konsumiert Tokens und führt Modelle aus; die andere verwaltet, abrechnet und gewährt Berechtigungen. Das Unterbringen beider Systeme auf zwei verschiedenen Domains und mit zwei separaten Sätzen von Schlüsseln garantiert, dass ein gestohlener Anwendungsschlüssel niemals andere Schlüssel erstellen oder Ihre Abrechnungsdaten einsehen kann.
https://management-api.x.ai
Verwechseln Sie dies nicht mit https://api.x.ai, was die URL für Inferenzaufrufe (Chat-Vervollständigungen, Embeddings usw.) ist. Alle Management-Anfragen – Schlüssel, Abrechnung, Analysen – laufen über management-api.x.ai.
Authentifizierung der Management-API
Der Authentifizierungsmechanismus ist identisch – ein Bearer-Token im Authorization-Header – doch der Schlüssel selbst ist es nicht. Dies ist die häufigste Verwirrung beim Einstieg und führt zu einer völlig undurchsichtigen Fehlermeldung 401: In der Fehlermeldung wird nichts angezeigt, das darauf hindeuten würde, dass Sie den richtigen Schlüssel einfach an die falsche API übermittelt haben.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dieser Validierungsaufruf (GET /auth/management-keys/validation) ermöglicht es Ihnen, zu überprüfen, ob Ihr Management-Schlüssel gültig und aktiv ist. Er ist der einfachste Einstiegspunkt, um Ihre Konfiguration zu testen.
Management-Schlüssel vs. Inferenz-Schlüssel
- Management-Schlüssel: Gewährt Zugriff auf Endpunkte von
management-api.x.ai(Verwaltung, Abrechnung, Analysen) - Inferenz-Schlüssel: Gewährt Zugriff auf Endpunkte von
api.x.ai(Chat, Embeddings, Bilder)
Beide Schlüsseltypen werden im xAI-Konsole generiert, unterscheiden sich jedoch in ihrem Geltungsbereich. Ein Inferenz-Schlüssel kann keine Management-Endpunkte erreichen, und umgekehrt.
Struktur der Endpunkte
Die Endpunkte der Management-API folgen einer logischen Organisation:
/auth/teams/{teamId}/api-keys— Verwaltung von API-Schlüsseln/auth/api-keys/{apiKeyId}— Operationen an einem bestimmten Schlüssel/auth/teams/{teamId}/models— zugängliche Modelle/auth/teams/{teamId}/endpoints— verfügbare ACL-Endpunkte/v1/billing/teams/{teamId}/— Abrechnung und Analysen
Der Parameter teamId ist die Kennung Ihres Teams in der xAI-Konsole und strukturiert fast alle Endpunkte. Jedes Team verfügt über eigene Schlüssel, Quoten und Abrechnungseinstellungen – was es zur natürlichen Isolierungseinheit macht: Die Trennung zweier Projekte in zwei Teams trennt auch deren Budgets und Zugriffe, ohne zusätzliche Konfiguration.
Ihr erster Management-Aufruf
Hier ist ein vollständiges Beispiel zur Validierung Ihrer Konfiguration:
# Definieren Sie Ihren Management-Schlüssel
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Validieren Sie den Schlüssel
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Wenn die Antwort Informationen zu Ihrem Team und Ihrem Schlüssel enthält, funktioniert Ihre Konfiguration. Wenn Sie einen Fehler 401 erhalten, überprüfen Sie, ob Sie einen Management-Schlüssel (und keinen Inferenz-Schlüssel) verwenden.
Kernaussagen
- Die Management-API verwendet
https://management-api.x.ai, was sich vonhttps://api.x.aiunterscheidet - Die Authentifizierung verwendet ein Bearer-Token im
Authorization-Header - Management-Schlüssel und Inferenz-Schlüssel haben getrennte Geltungsbereiche
- Der Endpunkt
GET /auth/management-keys/validationermöglicht es Ihnen, Ihre Konfiguration zu testen - Alle Management-Endpunkte sind um den
teamIdherum organisiert