Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Namenskonventionen

Lektion 13 von 14 Aktualisiert am 3. November 2026 Anfänger
Auf dieser Seite
  1. Modell-Identifikatoren verstehen
  2. Die drei Identifikator-Formate
  3. Aktuelle vollständige Identifikatoren
  4. Modell-Lebenszyklus
  5. Empfehlungen nach Umgebung
  6. Migration zwischen Versionen
  7. API-Endpunkte
  8. Kernaussagen

Aktualisiert am 3. November 2026. Basierend auf der xAI-Seite Models (Abschnitt Model Aliases): Die Tabelle enthält grok-4.7, das von xAI empfohlene Modell, sowie grok-4.6. Die Empfehlung für die Produktion folgt der Anleitung von xAI, die den Einsatz des Alias für die meisten Anwendungsfälle und die datierte Version für Workflows, die eine strikte Konsistenz erfordern, empfiehlt. Quelle: Models.

Modell-Identifikatoren verstehen

Wenn Sie die xAI API aufrufen, bestimmt das Feld model, welches Modell Ihre Anfrage verarbeitet. xAI verwendet ein strukturiertes Namenssystem mit Aliases und fixierten Versionen. Das Verständnis dieses Systems ist unerlässlich, um die Stabilität und Migration Ihrer Anwendungen zu verwalten.

Die drei Identifikator-Formate

xAI bietet drei Möglichkeiten, ein Modell zu referenzieren, wobei jedes eine eigene Verhaltensweise aufweist:

Einfacher Alias

{
  "model": "grok-4.20"
}

Der einfache Alias verweist auf die neueste stabile Version des Modells. Wenn xAI ein Minor-Update veröffentlicht, leitet der Alias automatisch zur neuen Version weiter. Ihre Anwendung nutzt stets die neueste stabile Version, ohne dass Codeänderungen erforderlich sind.

Vorteil: Sie profitieren automatisch von Verbesserungen. Risiko: Das Verhalten kann sich von einer Version zur nächsten leicht ändern.

Neuester Alias

{
  "model": "grok-4.20-latest"
}

Der neueste Alias verweist auf die Version am Rande des Experiments (bleeding edge) – die allerneueste Iteration, einschließlich Versionen, die noch nicht als stabil freigegeben wurden. Dies ist die aktuellste, aber potenziell am wenigsten getestete Version.

Vorteil: Unmittelbarer Zugriff auf die neuesten Verbesserungen. Risiko: Das Verhalten kann sich jederzeit ändern; Regressionen sind möglich.

Fixierte Version

{
  "model": "grok-4.20-0309"
}

Die fixierte Version identifiziert eine spezifische Modellversion, indiziert nach ihrem Veröffentlichungsdatum (hier: 9. März). Diese Version ändert sich nie: Das Verhalten, das Sie heute beobachten, wird in sechs Monaten identisch sein.

Vorteil: Vollständige Stabilität, reproduzierbare Ergebnisse. Risiko: Die Version wird mit der Zeit veraltet und schließlich entfernt.

Aktuelle vollständige Identifikatoren

API-Identifikator Typ Verhalten
grok-4.20-0309-reasoning Fixierte Version Ändert sich nie
grok-4.20-0309-non-reasoning Fixierte Version Ändert sich nie
grok-4.20-multi-agent-0309 Fixierte Version Ändert sich nie
grok-4.7 Alias Neueste stabile Version des von xAI empfohlenen Modells
grok-4.6 Alias Neueste stabile Version
grok-4.5 Alias Neueste stabile Version (Alias `grok-4.5-latest` für die allerneueste Version)
grok-4.3 Alias Neueste stabile Version
grok-build-0.1 Alias Code-Modell, neueste stabile Version

Modell-Lebenszyklus

Jedes xAI-Modell durchläuft einen dreiphasigen Lebenszyklus:

  1. Aktiv – Das Modell ist verfügbar und für den produktiven Einsatz empfohlen.
  2. Veraltet – Das Modell funktioniert weiterhin, aber xAI empfiehlt die Migration auf eine neuere Version. Ein Fristdatum wird vor der Entfernung bekannt gegeben.
  3. Verworfen – Das Modell wurde entfernt. Anfragen an dieses Modell führen zu Fehlern.

Achten Sie auf Deprecation-Ankündigungen auf der xAI-Konsole und in den Release Notes. Wenn ein Modell veraltet ist, planen Sie Ihre Migration, ohne auf das Entferndatum zu warten.

Empfehlungen nach Umgebung

Entwicklung

Verwenden Sie einfache Aliases (grok-4.7, grok-4.3), um automatisch von Verbesserungen zu profitieren. In der Entwicklung ist eine leichte Verhaltensänderung zwischen Versionen akzeptabel und ermöglicht es Ihnen, Inkompatibilitäten vor der Produktion zu erkennen.

Staging und Testumgebungen

Verwenden Sie fixierte Versionen (grok-4.20-0309-reasoning), um die Reproduzierbarkeit von Tests sicherzustellen. Wenn ein Test heute besteht, muss er morgen mit exakt demselben Ergebnis bestehen.

Produktion

xAI empfiehlt den einfachen Alias oder den -latest-Alias für die meisten Anwendungsfälle, sodass Sie automatisch von neuen Funktionen profitieren können, und reserviert die datierte Version für Workflows, die eine strikte Konsistenz erfordern. Wenn Ihre Produktion in diese Kategorie fällt – überprüfbare Ergebnisse, Compliance, Regressionstests – fixieren Sie die datierte Version und planen Sie periodische Migrationen nach der Validierung im Staging.

Migration zwischen Versionen

Wenn Sie von einer Version auf eine andere migrieren:

  1. Aktualisieren Sie das Feld model in Ihren Anfragen
  2. Testen Sie Ihre bestehenden Prompts – neuere Modelle können unterschiedlich antworten
  3. Überprüfen Sie API-Parameter – eine neue Version kann bestimmte Parameter unterstützen oder veralten
  4. Validieren Sie die Ergebnisse – vergleichen Sie die Ausgaben der alten und neuen Versionen qualitativ

API-Endpunkte

xAI unterhält zwei Hauptendpunkte:

  • /v1/responses – Der Hauptendpunkt, der für alle neuen Projekte empfohlen wird
  • /v1/chat/completions – Der Legacy-Endpunkt, der für die Kompatibilität mit bestehenden Clients aufrechterhalten wird

Der Legacy-Endpunkt erhält keine neuen Funktionen mehr. Wenn Sie ein neues Projekt starten, verwenden Sie /v1/responses ausschließlich.

Kernaussagen

  • Drei Formate: einfacher Alias (stabil), neuester Alias (bleeding edge), fixierte Version (unveränderlich)
  • In der Produktion verwenden Sie fixierte Versionen für Stabilität
  • In der Entwicklung verwenden Sie Aliases, um von Verbesserungen zu profitieren
  • Achten Sie auf Deprecation-Ankündigungen und planen Sie Ihre Migrationen
  • Der empfohlene Endpunkt ist /v1/responses, nicht /v1/chat/completions
  • Testen Sie Ihre Prompts immer, wenn Sie zwischen Versionen migrieren