Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Chat Completions vs Responses API: Vergleich

Lektion 11 von 12 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Zwei Endpunkte, zwei Philosophien
  2. Zustandsmanagement: Der fundamentale Unterschied
  3. Exklusive Tools und Funktionen
  4. Wann Chat Completions verwenden?
  5. Wann die Responses API verwenden?
  6. Kernaussagen

Zwei Endpunkte, zwei Philosophien

xAI bietet zwei Endpunkte zur Interaktion mit Grok-Modellen: Chat Completions (/v1/chat/completions) und die Responses API (/v1/responses). Das Verständnis ihrer Unterschiede ist unerlässlich, um den richtigen Endpunkt für Ihr Projekt zu wählen und eventuelle Migrationen zu planen.

Aspekt Chat Completions API Responses
Status Legacy Primär (empfohlen)
Zustandsmanagement Stateless (Gesendete Historie) Stateful (previous_response_id)
Server-Speicherung Nein Ja (30 Tage mit store: true)
Konversation Nachrichtenarray Über ID verknüpft
Server-Tools Nur Funktionsaufrufe web_search, x_search, code_interpreter, functions
Verschlüsselte Reasoning Nein Ja (encrypted_content)
Neue Funktionen Nicht priorisiert Priorisiert
OpenAI-Kompatibilität Vollständig Teilweise

Zustandsmanagement: Der fundamentale Unterschied

Chat Completions: Sie verwalten die Historie

Bei jedem Aufruf müssen Sie die gesamte Konversation erneut senden:

# Chat Completions — alles jedes Mal erneut senden
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "Sie sind ein hilfreicher Assistent."},
        {"role": "user", "content": "Hallo, mein Name ist Alice."},
        {"role": "assistant", "content": "Hallo Alice! Wie kann ich Ihnen helfen?"},
        {"role": "user", "content": "Wie ist mein Vorname?"}
    ]
)

Responses API: Der Server verwaltet die Historie

Bei der Responses API reicht ein einfacher Kennzeichner, um eine Konversation fortzusetzen:

# Responses API — nur die ID der vorherigen Antwort
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hallo, mein Name ist Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Wie ist mein Vorname?",
    previous_response_id=response1.id
)

Der Server behält den Kontext und rekonstruiert die Historie automatisch. Sie sparen nicht weniger Token (die Historie wird weiterhin berechnet), aber Sie vereinfachen Ihren Code und reduzieren die Größe Ihrer Anfragen.

Exklusive Tools und Funktionen

Die Responses API bietet Zugriff auf Server-Tools, die Chat Completions nicht zur Verfügung stellt:

  • web_search: Echtzeit-Web-Suche
  • x_search: Suche innerhalb von X (Twitter)-Posts
  • code_interpreter: Serverseitige Python-Codeausführung

Diese Tools sind direkt in die Anfrage integriert:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Was sind die neuesten Nachrichten über KI?",
    tools=[{"type": "web_search"}]
)

Chat Completions unterstützt Funktionsaufrufe (vom Entwickler definierte Tools), bietet jedoch nicht diese von xAI verwalteten Server-Tools.

Wann Chat Completions verwenden?

Chat Completions bleibt in mehreren Szenarien die richtige Wahl:

  • Migration von OpenAI: Ihr bestehender Code funktioniert ohne wesentliche Änderungen
  • Multi-Provider: Sie möchten zwischen OpenAI, Anthropic und xAI mit demselben Code wechseln
  • Drittanbieter-Frameworks: LangChain, LlamaIndex, Haystack und die meisten Frameworks nutzen das Format von Chat Completions
  • Vollständige Kontrolle: Sie möchten die Historie selbst verwalten (Zusammenfassung, Filterung, Modifikation)

Wann die Responses API verwenden?

Die Responses API ist vorzuziehen für:

  • Neue Projekte: Nutzen Sie die neuesten Funktionen von Anfang an
  • Server-Tools: Benötigen Sie Web-Suche, Codeausführung oder X-Suche
  • Lange Konversationen: Kein Bedarf, bei jedem Aufruf die Historie erneut zu senden
  • Verschlüsseltes Reasoning: Zugriff auf Reasoning-Inhalte für die Kontinuität zwischen Anfragen

Kernaussagen

  • Chat Completions ist stateless (Sie verwalten die Historie), die Responses API ist stateful (Server verwaltet)
  • Die Responses API bietet exklusive Server-Tools: web_search, x_search, code_interpreter
  • Chat Completions verfügt über vollständige OpenAI-Kompatibilität, die Responses API ist spezifisch für xAI
  • Beide Endpunkte berechnen die Gebühr für die gesamte Konversationshistorie
  • Nutzen Sie Chat Completions für Kompatibilität und die Responses API für neue Funktionen