xAI API und Kompatibilität mit OpenAI
Auf dieser Seite
Eine vertraute API
Die xAI API verwendet das gleiche Format wie die OpenAI API. Wenn Sie bereits mit der OpenAI API oder kompatiblen Tools gearbeitet haben, müssen Sie nichts Neues lernen. Das einzige, was sich ändert, ist die Basis-URL.
https://api.x.ai/v1
Diese Kompatibilität ist eine strategische Entscheidung von xAI. Anstatt ein neues, proprietäres Format aufzuzwingen, haben sie sich für den de facto-Industriestandard entschieden. Infolgedessen können jedes Tool, jede Softwareentwicklungsbibliothek (SDK) oder jeder Editor, der die OpenAI API unterstützt, grok-build-0.1 sofort verwenden.
Minimale Konfiguration
Um von OpenAI zu xAI in jedem kompatiblen Client zu wechseln, müssen Sie nur zwei Parameter ändern:
- Basis-URL: Ersetzen Sie
https://api.openai.com/v1durchhttps://api.x.ai/v1 - API-Schlüssel: Verwenden Sie Ihren xAI API-Schlüssel (erhalten von
console.x.ai)
Alles andere – Nachrichtenformat, Temperatur-Parameter, Antwortstruktur – ist identisch.
Beispiel mit dem OpenAI Python SDK
from openai import OpenAI
client = OpenAI(
api_key="your-xai-key",
base_url="https://api.x.ai/v1"
)
response = client.chat.completions.create(
model="grok-build-0.1",
messages=[
{"role": "system", "content": "Sie sind eine Programmierassistentin."},
{"role": "user", "content": "Schreiben Sie eine Quicksort-Funktion in Python."}
]
)
Sie verwenden den Standard-OpenAI SDK ohne Änderungen. Nur base_url und der Modellname ändern sich.
Beispiel mit curl
curl https://api.x.ai/v1/chat/completions \
-H "Authorization: Bearer your-xai-key" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-build-0.1",
"messages": [
{"role": "user", "content": "Erklären Sie den Unterschied zwischen let und const in JavaScript"}
]
}'
API-Schlüssel erhalten
- Gehen Sie zu console.x.ai
- Melden Sie sich mit Ihrem xAI-Konto an (oder erstellen Sie eines unter accounts.x.ai)
- Im Bereich API-Schlüssel generieren Sie einen neuen Schlüssel
- Kopieren Sie ihn sofort – er wird nicht erneut angezeigt
Bewahren Sie diesen Schlüssel sicher auf. Geben Sie ihn niemals in ein Git-Repository ein oder teilen Sie ihn im Team-Chat. Verwenden Sie eine Umgebungsvariable oder einen Secrets-Manager.
Verfügbare Endpunkte
grok-build-0.1 unterstützt die folgenden Endpunkte, alle im OpenAI-Format:
/v1/chat/completions: Text- und Codegenerierung (am häufigsten verwendet)/v1/chat/completionsmitstream: true: Streaming mitreasoning_content/v1/chat/completionsmittools: natives Tool-Calling
Kompatibilitätsbeschränkungen
Es bestehen einige geringfügige Unterschiede:
- Die verfügbaren Modelle sind die von xAI (grok-build-0.1, grok-4.5 usw.), nicht die von OpenAI
- Einige OpenAI-spezifische Parameter (wie
logprobs) werden möglicherweise nicht unterstützt reasoning_contentist spezifisch für die xAI API und existiert nicht in der OpenAI API
Kernaussagen
- Die xAI API befindet sich unter
https://api.x.ai/v1und ist mit dem OpenAI-Format kompatibel - Sie müssen nur die Basis-URL und den API-Schlüssel ändern, um zu migrieren
- Der OpenAI Python SDK funktioniert so, wie er ist
- Holen Sie sich den API-Schlüssel unter console.x.ai
- Alle OpenAI-kompatiblen Editoren funktionieren mit xAI