Basis-URL und Authentifizierung
Unsere API folgt dem OpenAI Chat Completions Standard. Um mit dem Dienst zu interagieren, richtest du deinen Client auf https://api.grokapikey.com/v1 und fügst deinen eindeutigen API-Schlüssel in den Authorization Header ein. Du kannst diesen Schlüssel sofort nach der Anmeldung mit E-Mail und Passwort generieren. Der Schlüssel wird einmalig bei der Erstellung angezeigt, speichere ihn also sicher. Wenn du ihn verlierst, kannst du über dein Dashboard einen neuen Schlüssel generieren, wodurch der vorherige sofort ungültig wird. Für das Testkonto ist keine Kreditkarte erforderlich.
Deine erste Anfrage
Beginne mit dem Senden eines einfachen Text-Prompts, um die Konnektivität zu überprüfen. Verwende den standardmäßigen chat/completions-Endpunkt mit der Modellkennung uncensored. Das folgende Beispiel zeigt einen grundlegenden curl-Befehl zum Testen der Verbindung. Dies bestätigt, dass deine Authentifizierung korrekt ist und der Dienst antwortet. Du kannst diese Struktur dann für deine spezifische Anwendungslogik anpassen.
Ersetze YOUR_API_KEY vor der Ausführung dieses Befehls durch deinen tatsächlichen Schlüssel.
curl https://api.grokapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK-Integration
Wenn du eine Python-Anwendung entwickelst, verwende die offizielle openai-Bibliothek. Konfiguriere den Client, um unsere Basis-URL und deinen API-Schlüssel zu verwenden. So kannst du vertraute Python-Idiome nutzen, während du auf das unzensierte Modell zugreifst. Der Client verarbeitet Serialisierung und Streaming automatisch. Stelle sicher, dass die neueste Version der Bibliothek in deiner Umgebung installiert ist, um die beste Kompatibilität mit unseren Endpunkten zu gewährleisten.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node.js SDK-Integration
Für JavaScript- oder TypeScript-Projekte funktioniert das Node.js OpenAI SDK out of the box. Setze die Eigenschaften apiKey und baseURL in deinem Konfigurationsobjekt. Dies stellt sicher, dass alle nachfolgenden Anfragen über unsere Infrastruktur geleitet werden. Du kannst Standard-async/await-Muster verwenden, um Antworten zu verarbeiten. Dieser Ansatz ist ideal für serverseitige Anwendungen oder Edge-Funktionen, die direkten API-Zugriff benötigen, ohne über OpenAI zu proxyen.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
Streaming-Antworten
Aktiviere für Anwendungen, die von Echtzeit-Token-Generierung profitieren, das Streaming, indem du stream: true im Anfragekörper setzt. Die API gibt einen Server-Sent Events (SSE)-Stream von Teilantworten zurück. Dies reduziert die wahrgenommene Latenz für Nutzer und ermöglicht die sofortige Anzeige des generierten Texts. Jeder Chunk enthält ein Delta der Antwort. Verarbeite diese Events in deinem Client-Code, um die Benutzeroberfläche schrittweise zu aktualisieren. Streaming verbraucht Tokens normal und hat keinen Einfluss auf die Preise.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Grenzen, Fehler und Kontext
Jeder API-Schlüssel ist auf 300 Anfragen pro Minute und eine maximale Anfragekörpergröße von 8 MB begrenzt. Wenn du das Ratenlimit überschreitest, gibt die API einen 429-Statuscode zurück; warte ein paar Sekunden und versuche es erneut. Ein 401-Fehler deutet auf einen ungültigen oder widerrufenen Schlüssel hin, während ein 402-Fehler bedeutet, dass dein Prepaid-Guthaben aufgebraucht ist. Das Modell unterstützt ein Kontextfenster von 100.000 Token für Eingabe und Ausgabe zusammen. Stelle sicher, dass deine Prompts in dieses Limit passen, um ein Abschneiden zu vermeiden. Inhaltsfilter sind minimal, mit Ausnahme einer harten Blockade für sexuellen Inhalt, der Minderjährige betrifft.