Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Basis-URL und erster Aufruf

Lektion 1 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Die Management-API: Eine getrennte Steuerungs-Ebene
  2. Basis-URL
  3. Authentifizierung der Management-API
  4. Struktur der Endpunkte
  5. Ihr erster Management-Aufruf
  6. Kernaussagen

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.

2
Unterschiedliche URLs
REST
Standard-Architektur
JSON
Austauschformat
Bearer
Authentifizierung

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 von https://api.x.ai unterscheidet
  • 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/validation ermöglicht es Ihnen, Ihre Konfiguration zu testen
  • Alle Management-Endpunkte sind um den teamId herum organisiert