API-Schlüssel generieren
Auf dieser Seite
Programmatischer Zugriff auf Grok
Der API-Schlüssel ist das Authentifizierungstoken, das Ihren Anwendungen ermöglicht, mit den Grok-Modellen zu kommunizieren. Ohne ihn werden keine Anfragen verarbeitet. Diese Lektion führt Sie durch die Erstellung und Verwaltung Ihrer Schlüssel in der xAI-Konsole.
Konsole öffnen
Gehen Sie zu console.x.ai und melden Sie sich mit dem Konto an, das im vorherigen Schritt erstellt wurde. Die Konsole dient als zentrales Dashboard zur Verwaltung von Schlüsseln, Überwachung des Verbrauchs und Einrichtung der Abrechnung.
Öffnen Sie im Seitenmenü API-Schlüssel (vollständiger Pfad: console.x.ai/team/default/api-keys).
Erstellen Sie Ihren ersten Schlüssel
Klicken Sie auf Create API Key. Sie können jedem Schlüssel einen beschreibenden Namen geben, um zu identifizieren, wofür er verwendet wird:
dev-localfür Ihre Entwicklungsumgebungprod-backendfür Ihren Produktionsservertest-cifür Ihre Continuous-Integration-Pipeline
Der Schlüssel wird nur einmal angezeigt, wenn Sie ihn erstellen. Kopieren Sie ihn sofort und speichern Sie ihn an einem sicheren Ort (z. B. ein Passwort-Manager oder ein Secrets-Vault). Wenn Sie einen Schlüssel verlieren, müssen Sie einen neuen generieren.
Schlüssel-Format
xAI-API-Schlüssel beginnen mit dem Präfix xai-, gefolgt von einer alphanumerischen Zeichenkette. Dieses Präfix hilft Ihnen, sie in Ihren Konfigurationsdateien schnell zu erkennen und zu identifizieren, falls sie versehentlich im Quellcode offengelegt werden.
Best Practices für die Verwaltung
Ein Schlüssel pro Umgebung
Erstellen Sie für jeden Kontext separate Schlüssel. Falls ein Schlüssel kompromittiert wird, können Sie ihn widerrufen, ohne andere Umgebungen zu beeinträchtigen.
Regelmäßige Rotation
Erneuern Sie Ihre Schlüssel in regelmäßigen Abständen, insbesondere für Produktionsumgebungen. Das Verfahren ist einfach: Erstellen Sie einen neuen Schlüssel, aktualisieren Sie Ihre Anwendung und löschen Sie den alten Schlüssel.
Prüfen vor Weitergabe
Bevor Sie ein Projekt teilen, stellen Sie sicher, dass kein Schlüssel im Quellcode fest codiert ist. Verwenden Sie .env-Dateien, die außerhalb der Versionskontrolle liegen (fügen Sie .env zu Ihrem .gitignore hinzu).
Abrechnung an Schlüssel gebunden
Jede API-Anfrage, die mit einem Schlüssel gestellt wird, wird gezählt und abgerechnet. xAI bietet zwei Modi:
- Vorkaufguthaben: Sie kaufen Guthaben im Voraus, und die Anfragen werden sofort abgezogen
- Monatliche Abrechnung: Der Verbrauch über das Guthaben hinaus wird am Monatsende abgerechnet
Prüfen Sie Ihre Abrechnungsinformationen in der Konsole vor dem ersten Einsatz der API, da Rechnungen nicht nachträglich geändert werden können.
Schlüssel sofort testen
Nehmen Sie dreißig Sekunden, um den Schlüssel zu validieren, bevor Sie ihn in einem Projekt verstecken. Der einfachste Test fragt nach der Liste der Modelle:
curl https://api.x.ai/v1/models \
-H "Authorization: Bearer xai-your-key"
Eine JSON-Antwort, die die Modelle auflistet, bestätigt, dass der Schlüssel aktiv ist und die Abrechnung korrekt läuft. Ein Fehler 401 bedeutet, dass der Schlüssel falsch kopiert wurde; ein Fehler 403 weist auf ein Problem mit Berechtigungen oder Guthaben hin. Die Diagnose an dieser Quelle spart Ihnen später eine Debugging-Sitzung mitten in Ihrem Anwendungscod.
Kernaussagen
- Sie erstellen Schlüssel unter console.x.ai/team/default/api-keys
- Sie beginnen mit
xai-und werden nur einmal angezeigt - Erstellen Sie einen Schlüssel pro Umgebung und speichern Sie sie in einem Secrets-Vault
- Prüfen Sie Ihren Abrechnungsmodus vor jeder API-Anfrage
- Validieren Sie jeden neuen Schlüssel mit einem Aufruf von
/v1/models, bevor Sie ihn integrieren