Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

xAI API und Kompatibilität mit OpenAI

Lektion 4 von 14 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Eine vertraute API
  2. Minimale Konfiguration
  3. API-Schlüssel erhalten
  4. Verfügbare Endpunkte
  5. Kompatibilitätsbeschränkungen
  6. Kernaussagen

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:

  1. Basis-URL: Ersetzen Sie https://api.openai.com/v1 durch https://api.x.ai/v1
  2. 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

  1. Gehen Sie zu console.x.ai
  2. Melden Sie sich mit Ihrem xAI-Konto an (oder erstellen Sie eines unter accounts.x.ai)
  3. Im Bereich API-Schlüssel generieren Sie einen neuen Schlüssel
  4. 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/completions mit stream: true: Streaming mit reasoning_content
  • /v1/chat/completions mit tools: 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_content ist spezifisch für die xAI API und existiert nicht in der OpenAI API

Kernaussagen

  • Die xAI API befindet sich unter https://api.x.ai/v1 und 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