Start → Hilfe

404 auf /responses – auch die Responses API braucht das Versionspräfix

Was Sie sehen

• 404 Not Found on /responses
• openai.NotFoundError: Error code: 404
• The same key works for chat/completions but not for responses
• Nothing appears in the usage log for the failed call

Warum das passiert

Das Präfix gehört zur Base URL, nicht zum einzelnen Endpunkt. Endet base_url erst einmal auf /v1, erzeugt das SDK für jeden unterstützten Endpunkt den richtigen Pfad, und Sie müssen nie wieder daran denken.

Bei handgeschriebenen Anfragen geht es kaputt. Jemand kopiert ein curl-Beispiel aus einem Blog, das die volle URL ausgeschrieben hat, ändert den Host und verliert beim Bearbeiten das Präfix.

Weil das 404 am Edge zurückkommt, hinterlässt es keine Spur im Anfrageverlauf des Kontos. Leute nehmen dann an, der Endpunkt werde gar nicht unterstützt, obwohl sie ihn nie erreicht haben.

Prüfen, ob es daran liegt

Vergleichen Sie die beiden Pfade mit demselben Schlüssel – der Unterschied ist eindeutig:

curl -s -o /dev/null -w 'no prefix: %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/responses' -H 'Authorization: Bearer YOUR_KEY'
curl -s -o /dev/null -w 'with /v1:  %{http_code}\n' -X POST \
  'https://YOUR_DOMAIN/v1/responses' -H 'Authorization: Bearer YOUR_KEY'

Ein 404 beim ersten und 400 oder 200 beim zweiten bestätigt es. Ein 401 beim zweiten heißt, der Pfad stimmt und der Schlüssel ist falsch – ein anderes Problem.

So beheben Sie es

1. Das Präfix einmal setzen, in base_urlSetzen Sie /v1 ans Ende der Base URL und lassen Sie das SDK jeden Endpunktpfad bauen. Einzelne URLs zu bearbeiten ist genau der Weg, auf dem das Präfix verloren geht.
2. Prüfen, welche Endpunkte das Gateway wirklich anbietetNicht jedes OpenAI-kompatible Gateway implementiert die Responses API. Liefert /v1/responses 404, während /v1/chat/completions funktioniert, ist das Präfix in Ordnung und der Endpunkt fehlt wirklich – nehmen Sie dann chat/completions.

Verwandte Themen

Zuletzt geprüft am 2026-10-01. Geschrieben aus Problemen, die auf einem laufenden OpenAI-kompatiblen Gateway diagnostiziert wurden – nicht von anderen Seiten zusammengetragen.