Responses API oder Chat Completions?
Vergleichen Sie Anfrageformat, Streaming, Tools und Anbieterkompatibilität, bevor Sie für Ihre KI-Anwendung die Responses API oder Chat Completions wählen.

Die Responses API und Chat Completions senden beide Prompts an Sprachmodelle, organisieren Eingabe, Ausgabe, Tools und Streaming aber unterschiedlich. Die Wahl sollte beim Vertrag zwischen Client und Modell beginnen – nicht bei der Annahme, dass ein neuerer Endpunkt automatisch bei jedem Anbieter funktioniert.
Die kürzeste Entscheidungsregel lautet:
- Verwenden Sie die Responses API für einen Coding-Agenten oder eine Anwendung, die bereits Responses-Items, Tool-Events und den Streaming-Ablauf der Responses API erwartet.
- Verwenden Sie Chat Completions für breit kompatible Chat-Clients und für Anbieterfamilien, die ihre Modelle im OpenAI-Stil per unverändertem Chat-Completions-Passthrough bereitstellen.
Prüfen Sie das unterstützte API-Format des gewählten Modells immer unter Modelle & Preise.
Protokolle im Vergleich
| Frage | Responses API | Chat Completions |
|---|---|---|
| Primäre Eingabeform | input und typisierte Eingabe-Items | Ein messages-Array |
| Ausgabemodell | Typisierte Ausgabe-Items und Events | Choices mit Assistant-Nachrichten und Deltas |
| Streaming | Responses-Eventstream | Stream aus Chat-Completion-Chunks |
| Tool-Aktivität | Typisierte Tool-Call- und Tool-Output-Items | Tool-Aufrufe an Assistant-Nachrichten |
| Am besten geeignet für | Agenten, Coding-Tools und Responses-native Anwendungen | Chat-Clients und weit verbreitete OpenAI-kompatible Anbieter |
| Modellportabilität | Nur für Responses geprüfte Modelle | Nur für Chat Completions geprüfte Modelle |
Die Tabelle beschreibt den Vertrag auf Protokollebene. Sie bedeutet nicht, dass Modelflare jede Anbieterfunktion zwischen beiden Formaten umwandelt.
Wann die Responses API besser passt
Wählen Sie /v1/responses, wenn der Client einen Modelllauf bereits als Folge typisierter Items behandelt und nicht als eine einzelne Assistant-Nachricht. Das ist bei Coding-Agenten üblich, die sichtbaren Text, Reasoning-Zusammenfassungen, Funktionsargumente, benutzerdefinierte Tool-Eingaben und weitere Events unterscheiden müssen.
Eine minimale Anfrage sieht so aus:
curl -sS https://modelflare.dev/v1/responses \
-H "Authorization: Bearer $MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"input": "List the three checks to make before an API migration.",
"stream": true
}'
Validieren Sie Responses-Streaming durchgängig. Ein Client, der Chat-Completions-Chunks versteht, aber keine Responses-Events, kann sich erfolgreich verbinden und trotzdem keine verwertbare Ausgabe darstellen.
Wann Chat Completions die sicherere Wahl ist
Wählen Sie /v1/chat/completions, wenn die Anwendung auf system-, user-, assistant- und tool-Nachrichten aufbaut oder wenn die gewählte Anbieterfamilie einen OpenAI-kompatiblen Chat-Completions-Endpunkt dokumentiert.
curl -sS https://modelflare.dev/v1/chat/completions \
-H "Authorization: Bearer $MODELFLARE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_CHAT_MODEL",
"messages": [
{"role": "system", "content": "Answer concisely."},
{"role": "user", "content": "What should an API health check verify?"}
],
"stream": true
}'
Für Anbieterfamilien außerhalb von OpenAI kann Modelflare ein unverändertes Chat-Completions-Passthrough bereitstellen, damit private Anfragefelder wie anbieterspezifische Reasoning- oder Suchoptionen den Dienstanbieter unverändert erreichen. Dieses Verhalten ist bewusst enger gefasst als die Behauptung vollständiger Responses-Kompatibilität.
Nicht allein nach dem Modellnamen entscheiden
Drei getrennte Prüfungen sind erforderlich:
- Der API-Schlüssel hat Zugriff auf das Modell. Der Zugriff hängt vom Schlüssel und den verfügbaren Modellgruppen ab.
- Das Modell unterstützt den Endpunkt. Ein Modell in /v1/models ist nicht automatisch für beide Anfrageformate gültig.
- Der Client versteht den Stream. Responses-Events und Chat-Completions-Chunks sind unterschiedliche Client-Verträge.
Schlägt eine dieser Prüfungen fehl, kann ein bloßer Wechsel des Endpunktpfads aus einem eindeutigen Kompatibilitätsfehler eine leere oder nur teilweise dargestellte Antwort machen.
Tools und strukturierte Ausgabe migrieren
Bevor Sie eine bestehende Integration umstellen:
- vergleichen Sie das vom Client verwendete Schema der Tool-Definitionen;
- prüfen Sie, wie Tool-Call-IDs und Tool-Ausgaben zurückgegeben werden;
- behalten Sie explizite optionale Werte bei, statt 0 oder false wegzulassen;
- prüfen Sie, ob der Anbieter private Felder benötigt, die unverändert durchgereicht werden müssen;
- testen Sie reine Tool-Antworten, die möglicherweise kein sichtbares Text-Delta enthalten;
- bestätigen Sie, wie der Client Abschluss und Nutzung erkennt.
Dass derselbe Prompt ähnlichen Text erzeugt, ist kein ausreichender Protokolltest. Ein echter Test sollte die Funktionen einschließen, von denen die Anwendung abhängt.
Ein praktischer Auswahlablauf
- Öffnen Sie Modelle & Preise und wählen Sie Modell und Gruppe aus.
- Bestätigen Sie das unterstützte API-Format.
- Folgen Sie einer clientspezifischen Anleitung in der Modelflare-Dokumentation, sofern vorhanden.
- Senden Sie eine Anfrage ohne Streaming.
- Senden Sie eine Streaming-Anfrage.
- Testen Sie Tools oder strukturierte Ausgabe.
- Prüfen Sie die Anfrage in den Nutzungsprotokollen auf Status, Zeiten, Token-Nutzung und Kosten.
Die Responses API ist kein universeller Ersatz für Chat Completions, und Chat Completions ist nicht veraltet. Das richtige Format ist dasjenige, das Client, ausgewähltes Modell und der Vertrag des Dienstanbieters gemeinsam unterstützen.
Nach der Formatwahl hilft Ihnen der KI-API-Streaming-Leitfaden dabei, Event-Parser, Zeitmessung, Abbruch und Timeout-Richtlinie umzusetzen.