So erstellst du einen Grok-API-Schlüssel, plus eine Alternative

Erstellen eines Schlüssels über den Anbieter

Wir sind ein unabhängiger Dienst und nicht die offizielle xAI-API, also benötigst du für den eigenen xAI-Schlüssel die eigenen Seiten von xAI. Der Ablauf ist bei den meisten Anbietern ähnlich, und die Menünamen können von den folgenden abweichen.

1. Melde dich mit deinem Konto in der Entwicklerkonsole des Anbieters an.
2. Überprüfe den Abrechnungsabschnitt. Einige Anbieter verlangen eine Zahlungsmethode oder eine Einzahlung, bevor ein Schlüssel funktioniert; lies, was dein Anbieter verlangt.
3. Öffne den Abschnitt API-Schlüssel und wähle die Option, einen neuen Schlüssel zu erstellen.
4. Gib ihm einen Namen, der angibt, wo er verwendet wird, z. B. das Projekt oder die Umgebung.
5. Kopiere den Schlüssel sofort. Viele Konsolen zeigen das vollständige Secret nur einmal an.
6. Speichere ihn in einem Secret-Manager oder einer Umgebungsvariable, niemals im Quellcode.

Wenn das Seitenlayout nicht übereinstimmt, ist die Dokumentation des Anbieters maßgeblich. Jeder vor Monaten erstellte Leitfaden, einschließlich diesem, kann eine ältere Benutzeroberfläche beschreiben.

Einen Schlüssel hier in unter einer Minute erhalten

Unser Schlüssel ist für einen OpenAI-kompatiblen Endpunkt, der ein gehostetes Open-Weight-Modell bedient, das darauf abgestimmt ist, ohne Inhaltsablehnungen für die legale erwachsene Nutzung zu antworten. Das Erhalten eines solchen Schlüssels dauert fünf Schritte.

1. Öffne die API-Schlüssel-Seite.
2. Melde dich mit Google oder mit einer E-Mail und einem Passwort an.
3. Klicke einmal, um dein kostenloses Testguthaben in Höhe von 0,50 $ zu beanspruchen. Es gilt einmal pro Person, 7 Tage lang und erfordert keine Karte.
4. Kopiere den auf der Seite angezeigten Schlüssel.
5. Führe den unten stehenden Testaufruf aus.

Die Base URL ist https://api.grokaiapikey.com/v1, die Modell-ID ist uncensored, und der Schlüssel kommt in den Authorization: Bearer Header.

Schlüssel testen

Starte mit curl. Wenn dies eine JSON-Antwort zurückgibt, sind dein Schlüssel, die Base URL und das Modell alle korrekt.

Copyexport API_KEY="paste-your-key-here"

curl https://api.grokaiapikey.com/v1/chat/completions   -H "Authorization: Bearer $API_KEY"   -H "Content-Type: application/json"   -d '{"model": "uncensored",
       "messages": [{"role": "user", "content": "Reply with the word ready."}]}'

In Node funktioniert das offizielle OpenAI-Paket, nachdem du zwei Einstellungen geändert hast.

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.grokaiapikey.com/v1",
  apiKey: process.env.API_KEY,
});

const r = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Reply with the word ready." }],
});
console.log(r.choices[0].message.content);

Python-Nutzer können dasselbe mit OpenAI(base_url=..., api_key=...) machen. Verfügbare Methoden sind POST /v1/chat/completions, POST /v1/responses und GET /v1/models.

Festlegen des Schlüssels als Umgebungsvariable

Füge einen Schlüssel niemals direkt in den Quellcode ein. Lege ihn in einer Umgebungsvariable ab und lese ihn zur Laufzeit aus. Die Befehle unterscheiden sich je nach System.

Copy# macOS or Linux, current shell session
export API_KEY="paste-your-key-here"

# Windows PowerShell, current session
$env:API_KEY = "paste-your-key-here"

# Check that the variable is set (macOS or Linux)
test -n "$API_KEY" && echo "key is set"

Speichere den Wert in einer .env-Datei, die in .gitignore steht, und lade sie mit dem Framework-Loader. Auf Servern nutze den Secret-Store oder die Umgebungsvariablen der Plattform. Die Base URL ist https://api.grokaiapikey.com/v1 und kann sicher im Code stehen.

Wenn du mehrere Dienste ausführst, gib jedem seinen eigenen Schlüssel. Konten, die aufgeladen haben, können bis zu 5 Schlüssel halten, sodass eine Staging-Kopie, eine Produktionskopie und ein persönlicher Testschlüssel nebeneinander existieren können, jeweils mit eigener Beschriftung.

Wenn der Aufruf fehlschlägt

Symptom	Wahrscheinliche Ursache	Lösung
401 Unauthorized	Fehlender oder falsch getippter Schlüssel	Überprüfe den Bearer-Header und suche nach einem nachgestellten Leerzeichen oder Anführungszeichen
404 Not Found	Falsche Base URL	Der Pfad muss /v1/chat/completions auf der api.-Subdomain sein
Modellfehler	Falscher Modellname	Nutze die Modell-ID uncensored
429 rate_limited	Zu viele Anfragen pro Minute	Trial-Schlüssel erlauben 60 pro Minute; verlangsamen
429 Parallelität	Zu viele gleichzeitig	Trial-Schlüssel erlauben 2 gleichzeitige Anfragen; ein Stream hält seinen Slot bis zum Ende belegt

Ein 429 mit Retry-After: 5-Header bedeutet temporäre Überlastung. Warte fünf Sekunden und versuche es erneut.

Verwende die Request-ID

Jede Antwort enthält den X-Request-Id-Header. Logge ihn neben deiner Fehlermeldung. Fragst du das Support-Team nach einem fehlgeschlagenen Aufruf, hilft die Request-ID, diesen exakt zu finden, statt zu raten. In curl füge -i hinzu, um die Header zu drucken, und im Python SDK lies sie über den Raw-Response-Helper.

Bei intermittierenden Problemen helfen Header: X-RateLimit-Limit-Requests und X-RateLimit-Limit-Concurrency zeigen die Limits für deinen Schlüssel, was sofort zeigt, ob du einen Trial-Schlüssel oder einen vollen Schlüssel hast.

Ersetzen oder Hinzufügen von Schlüsseln

Du musst niemanden bitten, einen Schlüssel zu rotieren. Auf der API-Schlüssel-Seite kannst du den Schlüssel jederzeit regenerieren (neu ausstellen), und der alte Schlüssel funktioniert sofort nicht mehr. Mache dies sofort, wenn ein Schlüssel in einem öffentlichen Repository, einem Screenshot oder einem gemeinsamen Chat landet.

Konten mit Aufladung können bis zu 5 Schlüssel halten. Vergib für jeden ein Label, z. B. staging oder mobile app, und widerrufe einen einzelnen Schlüssel, ohne die anderen zu berühren. Ein Schlüssel pro Umgebung ist eine gute Gewohnheit, denn das Widerrufen eines geleakten Staging-Schlüssels kostet deinen Produktionsdatenverkehr dann nichts.

Verwenden des Schlüssels in bestehenden Tools

Du musst keinen Code schreiben, um den Schlüssel zu verwenden. Viele Chat-Frontends und Entwickler-Tools akzeptieren einen benutzerdefinierten OpenAI-kompatiblen Endpunkt, und SillyTavern ist ein öffentliches Beispiel. Die Einrichtung fragt immer nach denselben drei Werten.

• Base URL: https://api.grokaiapikey.com/v1
• API-Schlüssel: der kopierte Schlüssel
• Modellname: uncensored

Einige Tools erwarten den vollständigen Pfad, der mit /chat/completions endet; andere fügen ihn selbst hinzu. Wenn du einen 404-Fehler erhältst, versuche die andere Variante. Wenn das Modell-Dropdown eines Tools leer bleibt, gib den Modellnamen manuell ein oder lass es die Liste über GET /v1/models abrufen, das die einzelne Modell-ID zurückgibt.

Das Streaming funktioniert über dieselben Einstellungen. Wenn Antworten statt Wort für Wort auf einmal erscheinen, suche nach einem Streaming-Schalter im Tool.

Einen Schlüssel sicher aufbewahren

• Halte ihn serverseitig. Ein Schlüssel, der in Browser-JavaScript oder einem mobilen App-Bundle platziert wird, kann von jedem gelesen werden.
• Lade ihn aus einer Umgebungsvariable und füge die Umgebungsdatei vor dem ersten Commit zu .gitignore hinzu.
• Setze ein Ausgabenverhalten: Beobachte den X-Balance-USD-Header, damit ein unerwarteter Rückgang auffällt.
• Verwende separate Schlüssel für verschiedene Dienste, damit du einen widerrufen kannst, ohne dass es an anderer Stelle zu Ausfällen kommt.

Sobald der Testaufruf funktioniert, lies die Dokumentation zu Streaming, Function Calling und JSON-Modus und schaue dir die Preisseite für die Tarife an: $0,15 pro 1M Input-Token und $0,50 pro 1M Output-Token. Wenn du dies gegen einen geschlossenen Anbieter abwägst, behandelt unser Artikel zu warum Entwickler auf unzensierte Modelle wechseln die Vor- und Nachteile.

Eine einfache Rotation

1. Erstelle oder regeneriere auf der API-Schlüssel-Seite den Schlüssel, den du ersetzen möchtest. Durch die Regeneration wird der alte Schlüssel sofort ungültig, also führe dies durch, wenn dein Code bereit ist, den neuen Wert zu übernehmen.
2. Aktualisiere die Umgebungsvariable oder das Secret an allen Stellen, an denen der Schlüssel verwendet wird.
3. Starte den Dienst neu und führe den curl-Test aus diesem Artikel aus.
4. Schreibe das Datum in deine Notizen. Eine Kalender-Erinnerung alle paar Monate reicht für die meisten Projekte aus.

Wenn du nach einer Aufladung mehrere beschriftete Schlüssel hast, rotiere sie einzeln. Widerrufe zuerst den Schlüssel, der mit einem Laptop oder einem ehemaligen Teamkollegen verbunden ist, da diese am wahrscheinlichsten geleakt werden.

Weitere Anleitungen

• Kostenloser Grok API-Schlüssel: Was ist real und was ist ein Betrug
• Claude API-Schlüssel: Warum Entwickler auf unzensierte Modelle wechseln