Start → Hilfe

404 auf /v1/chat/completions, obwohl der Endpunkt eindeutig existiert

Was Sie sehen

• 404 page not found
• {"error":{"message":"Invalid URL (GET /v1/chat/completions)"}}
• NotFoundError: Error code: 404

Warum das passiert

Das erwischt Leute eher beim Debuggen als im Betrieb. Sie fügen die URL in den Browser oder in ein Tool ein, das standardmäßig GET verwendet, sehen ein 404 und schließen, der Endpunkt sei ausgefallen. Der Endpunkt ist in Ordnung; er hat schlicht keinen GET-Handler.

Das lässt sich leicht prüfen: Ein Pfad, den es wirklich nicht gibt, und ein Pfad, der existiert, aber Ihre Methode ablehnt, liefern beide 404 – aber nur einer verhält sich anders, wenn Sie auf POST wechseln.

Prüfen, ob es daran liegt

Senden Sie denselben Pfad zweimal, einmal pro Methode, und vergleichen Sie:

# GET — expect 404 even on a healthy endpoint
curl -s -o /dev/null -w 'GET  %{http_code}\n' \
  'YOUR_BASE_URL/chat/completions'

# POST with a deliberately bad key — expect 401
curl -s -o /dev/null -w 'POST %{http_code}\n' -X POST \
  'YOUR_BASE_URL/chat/completions' \
  -H 'Authorization: Bearer invalid' \
  -H 'Content-Type: application/json' -d '{}'

GET 404 gefolgt von POST 401 heißt: Der Endpunkt ist gesund, Sie haben ihn nur falsch getestet. Zweimal 404 heißt: Der Pfad ist wirklich falsch.

So beheben Sie es

1. POST verwendenChat Completions, Messages und Embeddings sind alles POST-Endpunkte. Nur Listen-Endpunkte wie /v1/models antworten auf GET.
2. Pfadsegmente zählenDer vollständige Pfad ist /v1/chat/completions. Fehlt /v1 oder steht es doppelt, weil Ihr Client es ebenfalls anhängt, landen Sie in beiden Fällen auf Pfaden, die es nicht gibt.
3. Auf einen Proxy achten, der den Pfad umschreibtFirmen-Proxys und API-Gateways entfernen oder ergänzen manchmal ein Präfix. Vergleichen Sie die URL in den Logs Ihres Clients mit der, die der Server nach eigener Angabe empfangen hat.

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.