Chat Completions vs Responses API: Vergleich
Auf dieser Seite
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-Suchex_search: Suche innerhalb von X (Twitter)-Postscode_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